---
title: Webhook events: International payments
slug: apis/payments/international-payments/webhook-events-international-payments
description: Receive notifications for international payments for quote status changes and payment completions via webhooks.
docTags: 
createdAt: 2024-08-13T12:28:26.837Z
---

## Common events

When you work with Cross River accounts, cards and payments, you register for specific [webhooks](docId\:BN5XtgkJogBe-CtwomCbS) which have a specific [format](docId\:OIUK28uoUrZIbRmT8i7RS).

This table presents `international payments` webhook events that are described in detail below.

| Event Name                                                      | Description                                                                                                                        | Related Endpoint                                |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| [Core.Transaction.Completed](docId\:o9fUc2dKPczcl1h4yIChr)      | Transaction completed successfully                                                                                                 | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |
| [International.Payment.Returned](docId\:o9fUc2dKPczcl1h4yIChr)  |                                                                                                                                    | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |
| [International.Hold.Cleared  ](docId\:o9fUc2dKPczcl1h4yIChr)    | Hold on the international payment has cleared and the funds have be sent to the receiver's bank account.                           | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |
| [International.Hold.Escalated](docId\:o9fUc2dKPczcl1h4yIChr)    | International payment is on hold and it's status was escalated. This is often used to indicate that additional actions are needed. | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |
| [International.Payment.Sent](docId\:o9fUc2dKPczcl1h4yIChr)      | International payment has been successfully sent to the receiving institution.                                                     | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |
| [International.Payment.Canceled](docId\:o9fUc2dKPczcl1h4yIChr)  | International payment canceled at partner request.                                                                                 | [Cancel payment](docId\:SwyRh0F0e40q1DOFZmuNr)  |
| [International.Payment.Rejected](docId\:o9fUc2dKPczcl1h4yIChr)  | International payment was rejected from the receiving bank.                                                                        | [Send payment](docId\:eVBwhQlRGZlamLd2hRwVd)    |

## Core.Transaction.Completed

Transaction completed successfully.

:::CodeblockTabs
Sample Event

```curl
{
  "id": "f131d2c4-1b44-4edd-8b44-b3bd00836435",
  "eventName": "Core.Transaction.Completed",
  "status": "Pending",
  "partnerId": "19222b81-0e1e-452d-a842-b2f1011c16f3",
  "createdAt": "2025-12-24T02:58:22.903-05:00",
  "resources": [
    "core/v1/transactions/172c21b8-6a0d-4e17-975b-b3bd0083464d",
    "core/v1/transactions/3016a902-bf3b-4588-8223-b3bd008346b5"  
    ],  
    "details": [
    {      
      "transactionId": "172c21b8-6a0d-4e17-975b-b3bd0083464d",
      "transactionCode": "INTL Outgoing",
      "debitSubAccount": "158560897007",
      "debitMasterAccount": "158560897007",
      "debitResult": "OK",
      "creditSubAccount": "10014200011",
      "creditMasterAccount": "10014200011",
      "creditResult": "OK",
      "rail": "International",
      "railId": "payment/b4f74751-cb17-4b8c-83a9-b3bd008345be",
      "amount": "500",
      "currency": "usd",
      "clientIdentifier": null,
      "description": "International payment from 158560897007",
      "proposedAt": "12/24/2025 02:57:57",
      "executedAt": "12/24/2025 02:57:57",
      "schedule": ""    
      },    
      {      
        "transactionId": "3016a902-bf3b-4588-8223-b3bd008346b5",
        "transactionCode": "INTL Return",
        "debitSubAccount": "10014200011",
        "debitMasterAccount": "10014200011",
        "debitResult": "OK",
        "creditSubAccount": "158560897007",
        "creditMasterAccount": "158560897007",
        "creditResult": "OK",
        "rail": "International",
        "railId": "return/129fce4a-d324-4e8b-bec7-b3bd00834673",
        "amount": "500",
        "currency": "usd",
        "clientIdentifier": null,
        "description": "International return payment from 158560897007",
        "proposedAt": "12/24/2025 02:57:57",
        "executedAt": "12/24/2025 02:57:57",
        "schedule": ""
    }
  ]
}
```
:::

## International.Payment.Returned

The `referencedPaymentID` parameter links an inbound return to a prior outbound payment, used to clearly identify which original payment each specific return is linked to. If there is none, a `null` value is returned.

:::CodeblockTabs
Sample Event

```curl
{
  "id": "c256329e-8fb4-4492-96e8-b43200abe620",
  "eventName": "International.Payment.Sent",
  "status": "Pending",
  "partnerId": "19222b81-0e1e-452d-a842-b2f1011c16f3",
  "createdAt": "2026-04-20T06:25:51.893-04:00",
  "resources": [
    "international/v1/payments/4b0cd383-1cfb-4905-acbe-b43200ab3e33"
  ],
  "details": [
    {
      "paymentId": "4b0cd383-1cfb-4905-acbe-b43200ab3e33",
      "productId": "57146944-b145-4326-884d-b2f700ecf688",
      "quoteId": "ac6ad316-be57-4b27-b8fb-b43200ab2418",
      "fromCurrency": "usd",
      "toCurrency": "gbp",
      "fromAmount": "500",
      "toAmount": "375",
      "feeAmount": "0",
      "accountNumber": "158560897007",
      "status": "Completed",
      "purpose": "SRV",
      "rejectReason": null,
      "statusReason": null,
      "clientIdentifier": null,
      "priority": "True",
      "beneficiaryEntityType": "Individual",
      "beneficiaryCompanyName": null,
      "beneficiaryFirstName": "Jon",
      "beneficiaryLastName": "Smith",
      "beneficiaryAddress": "1 Street",
      "beneficiaryCity": "Winfield",
      "beneficiaryStateProvince": null,
      "beneficiaryPostalCode": "GB12345",
      "beneficiaryCountryCode": "GB",
      "referencedPaymentId": null
    }
  ]
```
:::

## Hold cleared

A hold on the international payment has cleared.

**Extended webhook event details**

:::CodeblockTabs
Sample Event

```curl
{
  "id": "2618e009-7339-41a8-bd4d-b0fb013a523b",
  "eventName": "International.Hold.Cleared",
  "status": "Pending",
  "partnerId": "e30bfd38-907a-45f1-b5b7-af08014c8e79",
  "createdAt": "2024-01-18T14:04:24.507-05:00",
  "resources": [
    "international/v1/payments/aefff994-148e-4f28-9ddc-b0fb013610c7/holds/62a79dad-8e47-48a3-a707-b0fb0136137b"
  ],
  "details": [
    {
      "holdId": "62a79dad-8e47-48a3-a707-b0fb0136137b",
      "paymentId": "aefff994-148e-4f28-9ddc-b0fb013610c7",
      "holdType": "InternalReview"
    }
  ]
}
```
:::

## Hold escalated

International payment is on hold and it's status was escalated. This is often used to indicate that additional actions are needed.

**Extended webhook event details**

:::CodeblockTabs
Sample Event

```curl
{
  "id": "9fd99994-f1e9-4b84-9386-b0fb01381f6f",
  "eventName": "International.Hold.Escalated",
  "status": "Pending",
  "partnerId": "e30bfd38-907a-45f1-b5b7-af08014c8e79",
  "createdAt": "2024-01-18T13:56:24.25-05:00",
  "resources": [
    "international/v1/payments/aefff994-148e-4f28-9ddc-b0fb013610c7/holds/62a79dad-8e47-48a3-a707-b0fb0136137b"
  ],
  "details": [
    {
      "holdId": "62a79dad-8e47-48a3-a707-b0fb0136137b",
      "paymentId": "aefff994-148e-4f28-9ddc-b0fb013610c7",
      "holdType": "InternalReview"
    }
  ]
}
```
:::

## Payment sent

International payment has been successfully sent to the receiving institution.

*Unique End-to-End Transaction Reference (*uetr) has been added at the bottom of the “details” portion, for all payment events (however, it will be null for events that are not payment sent). It is a *36-character UUID (ISO 20022/Swift) that identifies the SWIFT payment across all institutions in the chain. Use it to track the payment.*

**Extended webhook event details**

:::CodeblockTabs
Sample Event

```curl
{
  "id": "ff9b72ce-d770-42e8-b914-b4a800af80af",
  "eventName": "International.Payment.Sent",
  "status": "Pending",
  "partnerId": "19222b81-0e1e-452d-a842-b2f1011c16f3",
  "createdAt": "2026-08-16T06:38:59.147-04:00",
  "resources": [
    "international/v1/payments/4d6a7e3f-c94b-467d-83fc-b4a800af19cc"  ],
  "details": [
    {
      "paymentId": "4d6a7e3f-c94b-467d-83fc-b4a800af19cc",
      "productId": "57146944-b145-4326-884d-b2f700ecf688",
      "quoteId": "9df5ff56-1b74-4549-be60-b4a800aee9a8",
      "fromCurrency": "usd",
      "toCurrency": "gbp",
      "fromAmount": "500",
      "toAmount": "374",
      "feeAmount": "0",
      "accountNumber": "158560897007",
      "status": "Completed",
      "purpose": "SRV",
      "rejectReason": null,
      "statusReason": null,
      "clientIdentifier": null,
      "priority": "True",
      "beneficiaryEntityType": "Individual",
      "beneficiaryCompanyName": null,
      "beneficiaryFirstName": "Jon",
      "beneficiaryLastName": "Smith",
      "beneficiaryAddress": "1 Street",
      "beneficiaryCity": "Winfield",
      "beneficiaryStateProvince": null,
      "beneficiaryPostalCode": "GB12345",
      "beneficiaryCountryCode": "GB",
      "referencedPaymentId": null,
      "uetr": "c5dff89f-30eb-4136-a1f2-b4a800af76d3"    }
  ]
}
```
:::

## Payment canceled

International payment canceled at partner request.

**Extended webhook event details**

:::CodeblockTabs
Sample Event

```curl
{
  "id": "9370fa9b-3e1e-4077-a1f9-b0fb013a7568",
  "eventName": "International.Payment.Canceled",
  "status": "Pending",
  "partnerId": "e30bfd38-907a-45f1-b5b7-af08014c8e79",
  "createdAt": "2024-01-18T14:04:54.533-05:00",
  "resources": [
    "international/v1/payments/aefff994-148e-4f28-9ddc-b0fb013610c7"
  ],
  "details": [
    {
      "paymentId": "aefff994-148e-4f28-9ddc-b0fb013610c7",
      "productId": "e8164629-96ad-47d9-ba6a-af08014dd6d1",
      "quoteId": "b7f05b12-3205-4328-8eb6-b0fb0135fa26",
      "fromCurrency": "usd",
      "toCurrency": "eur",
      "fromAmount": "1026",
      "toAmount": "1075",
      "feeAmount": "1510",
      "accountNumber": "2283489405",
      "status": "Canceled",
      "reason": null,
      "clientIdentifier": "string",
      "priority": "True",
      "beneficiaryEntityType": "Individual",
      "beneficiaryCompanyName": null,
      "beneficiaryFirstName": "John",
      "beneficiaryLastName": "Doe",
      "beneficiaryAddress": "1234 somewhere lane",
      "beneficiaryCity": "seattle",
      "beneficiaryStateProvince": "WA",
      "beneficiaryPostalCode": "98001",
      "beneficiaryCountryCode": "us",
      "referencedPaymentId": null
    }
  ]
}
```
:::

## Payment rejected

International payment was rejected from the receiving bank. A `rejectReason` is provided.

**Extended webhook event details**

:::CodeblockTabs
Sample Event

```curl
{
  "id": "786F34C9-B789-4FCC-AC6A-B3D100A07C13",
  "eventName": "International.Payment.Rejected",
  "status": "Pending",
  "partnerId": "e30bfd38-907a-45f1-b5b7-af08014c8e79",
  "createdAt": "2026-01-13T14:04:54.533-05:00",
  "resources": [
    "international/v1/payments/62f9cea2-2963-42f0-b187-b3c800a5595e"
  ],
  "details": [
{
    "paymentId": "62f9cea2-2963-42f0-b187-b3c800a5595e",
    "productId": "57146944-b145-4326-884d-b2f700ecf688",
    "quoteId": "d8d3c5e0-1148-4423-a0da-b3c800a52243",
    "fromCurrency": "usd",
    "toCurrency": "gbp",
    "fromAmount": "10000",
    "toAmount": "7865",
    "feeAmount": "100",
    "accountNumber": "158560897007",
    "status": "Rejected",
    "purpose": "SRV",
    "rejectReason": "OfacUnableToDetermine",
    "clientIdentifier": null,
    "priority": "True",
    "beneficiaryEntityType": "Individual",
    "beneficiaryCompanyName": null,
    "beneficiaryFirstName": "Jon",
    "beneficiaryLastName": "Smith",
    "beneficiaryAddress": "1 Street",
    "beneficiaryCity": "Winfield",
    "beneficiaryStateProvince": null,
    "beneficiaryPostalCode": "GB12345",
    "beneficiaryCountryCode": "GB"
}
  ]
}
```
:::