Payments
International payments
Webhook events
6 min
when you work with cross river accounts, cards and payments, you register for specific accounts, cards and payment events which have a specific event formats this table presents international payments webhook events that are described in detail below event name description webhook events docid\ o9fuc2dkpczcl1h4yichr hold on the international payment has cleared and the funds have be sent to the receiver's bank account webhook events docid\ o9fuc2dkpczcl1h4yichr international payment is on hold and it's status was escalated this is often used to indicate that additional actions are needed webhook events docid\ o9fuc2dkpczcl1h4yichr international payment has been successfully sent to the receiving institution and the funds are available in the receiver's bank account webhook events docid\ o9fuc2dkpczcl1h4yichr international payment canceled at partner request webhook events docid\ o9fuc2dkpczcl1h4yichr international payment was rejected from the receiving bank hold cleared a hold on the international payment has cleared extended webhook event details sample event { "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 sample event { "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 and the funds are available in the receiver's bank account extended webhook event details sample event { "id" "9370fa9b 3e1e 4077 a1f9 b0fb013a7568", "eventname" "international payment sent", "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" "completed", "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" } ] } payment canceled international payment canceled at partner request extended webhook event details sample event { "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" } ] } payment rejected international payment was rejected from the receiving bank extended webhook event details sample event { "id" "9370fa9b 3e1e 4077 a1f9 b0fb013a7568", "eventname" "international payment rejected", "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" "rejected", "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" } ] }