Webhook events: International payments
Common events
When you work with Cross River accounts, cards and payments, you register for specific webhooks which have a specific format.
This table presents international payments webhook events that are described in detail below.
Event Name | Description | Related Endpoint |
|---|---|---|
Core.Transaction.CompletedCore.Transaction.Completed | Transaction completed successfully | |
International.Payment.ReturnedInternational.Payment.Returned | | |
Hold on the international payment has cleared and the funds have be sent to the receiver's bank account. | ||
International payment is on hold and it's status was escalated. This is often used to indicate that additional actions are needed. | ||
International payment has been successfully sent to the receiving institution. | ||
International payment canceled at partner request. | ||
International payment was rejected from the receiving bank. |
Core.Transaction.Completed
Transaction completed successfully.
{
"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.
{
"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
{
"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
{
"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
{
"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
{
"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
{
"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"
}
]
}