Webhook events: COS Card payments

Common events

When you work with Cross River accounts, cards and payments, you register for specific webhooks which have a specific event format.

This table presents Card Payments Webhook events that are described in detail below.

Event Name	Description
CardPayments.Card.ApprovedCardPayments.Card.Approved	When a card token authorization is approved
CardPayments.Card.RejectedCardPayments.Card.Rejected	When a card token authorization is rejected
CardPayments.Payment.ClearedCardPayments.Payment.Cleared	When a payment passes hold evaluations.
CardPayments.Payment.CompletedCardPayments.Payment.Completed	When a payment transaction is successfully completed
CardPayments.Payment.RejectedCardPayments.Payment.Rejected	When a payment transaction is rejected
CardPayments.Payment.FailedCardPayments.Payment.Failed	When a payment fails to submit
Core.Transaction.Completed	When a payment transaction is successfully completed

Event examples

CardPayments.Card.Approved

"Data": {
{
    "cardId": "759f4eab-5400-4e25-9815-b4af0085684e",
    "clientIdentifier": "string",
    "productId": "29f3022a-ccfc-42eb-aa8f-b29500f13d00",
    "cardBrand": "Visa",
    "panLastFour": "1111",
    "token": "39A99D770B354E63AC4EFAF64E757F24000000",
    "authorizationStatus": "Approved",
    "accountNumber": "2113556886",
    "masterAccountNumber": "2113556886",
    "avsResponseCode": "Y",
    "avsResponseDesc": null,
    "cvv2ResultCode": "M",
    "isCVVMatched": "True"
}

CardPayments.Card.Rejected

"Data": {
{
  "cardId": "ee7870ba-5ef7-4700-92ed-bed8a77abe7c",
  "clientIdentifier": "Test-e0be02",
  "productId": "52cd935d-92ef-403d-9633-b3b000a5766b",
  "cardBrand": "Visa",
  "panLastFour": "0006",
  "authorizationStatus": "Rejected",
     "authorizationStatus": "Approved",
    "accountNumber": "2113556886",
    "masterAccountNumber": "2113556886",
    "avsResponseCode": "N",
    "avsResponseDesc": "Neither street address nor postal code match",
    "cvv2ResultCode": "M",
    "isCVVMatched": "True"
}

CardPayments.Payment.Cleared

"Data": {
{
  "paymentId": "a2aaa112-16c5-49db-84d8-b38a00fa1b2c",
  "paymentType": "Push",
  "amount": "5",
  "retrievalReferenceId": null,
  "traceNumber": null,
  "reasonCode": null,
  "reasonDescription": null,
  "clientIdentifier": "638977248000000000",
  "coreTransactionId": "18b8597a-393f-483d-9897-b42c00aa5788"
}

CardPayments.Payment.Completed

"Data": {
{
  "paymentId": "8ede6bc9-9dd3-48e1-9488-b1720104c696",
  "paymentType": "Push",
  "amount": "2",
  "retrievalReferenceId": "413715103005",
  "traceNumber": "103005",
  "reasonCode": "00",
  "reasonDescription": "Approved",
  "clientIdentifier": "0.3.0-alpha.6-2",
  "coreTransactionId": "18b8597a-393f-483d-9897-b42c00aa5788"
}

CardPayments.Payment.Rejected

"Data": {
{
  "paymentId": "6e8043c7-f72e-41dd-a4ac-b39e01067fb0",
  "paymentType": "Push",
  "amount": "5",
  "retrievalReferenceId": null,
  "traceNumber": null,
  "reasonCode": null,
  "reasonDescription": null,
  "clientIdentifier": null,
  "coreTransactionId": "18b8597a-393f-483d-9897-b42c00aa5788"
}

CardPayments.Payment.Failed

"Data": {
{
  "paymentId": "eb8f80f8-6e1c-428f-be54-b1720103ea5d",
  "paymentType": "Push",
  "amount": "2",
  "retrievalReferenceId": null,
  "traceNumber": null,
  "reasonCode": "1000",
  "reasonDescription": "AddressLine1 for corresponding entity is required.",
  "clientIdentifier": "0.3.0-alpha.6-1",
  "coreTransactionId": "18b8597a-393f-483d-9897-b42c00aa5788"
}

Core.Transaction.Completed

PULL:
{    
     "id": "1C966B7F-ADAC-4D59-8434-B41C00BC39AB",
     "eventName": "Core.Transaction.Completed",
     "status": "Unregistered",
     "partnerId": "AB904B78-26E8-4175-A843-B3A7010CA1FF",
     "createdAt": "2026-03-29T07:25:18.603-04:00",
     "resources": [
         "core/v1/transactions/afb3c312-2f7c-4cbe-b5c3-b41c00bc39a0"
     ],
     "details": [
         {
             "transactionId": "afb3c312-2f7c-4cbe-b5c3-b41c00bc39a0",
             "transactionCode": "Card Pull",
             "debitSubAccount": "105877357084",
             "debitMasterAccount": "105877357084",
             "debitResult": "OK",
             "creditSubAccount": "144235477557",
             "creditMasterAccount": "144235477557",
             "creditResult": "OK",
             "rail": "CardPayments",
             "railId": "payment/61e90dbd-007d-4f3d-a9ce-b41c00bc3109",
             "amount": "5",
             "currency": "usd",
             "clientIdentifier": null,
             "description": "CardPayments from Card b2703437-a780-4c12-8e13-ac5faf5342e9 to Account 144235477557",
             "proposedAt": "03/29/2026 07:25:18",
             "executedAt": "03/29/2026 07:25:18",
             "schedule": ""
         }
     ]
  }
  

PUSH:
 {
     "id": "1883EFA6-1E42-40BA-890A-B41C012B2BE0",
     "eventName": "Core.Transaction.Completed", 
     "status": "Unregistered",
     "partnerId": "AB904B78-26E8-4175-A843-B3A7010CA1FF",
     "createdAt": "2026-03-29T14:09:15.150-04:00",
     "resources": [
         "core/v1/transactions/ccee19ab-ba83-44f5-b479-b41c012b2bd4"
     ],
     "details": [
         {
             "transactionId": "ccee19ab-ba83-44f5-b479-b41c012b2bd4",
             "transactionCode": "Card Push",
             "debitSubAccount": "144235477557",
             "debitMasterAccount": "144235477557",
             "debitResult": "OK",
             "creditSubAccount": "105877357084",
             "creditMasterAccount": "105877357084",
             "creditResult": "OK",
             "rail": "CardPayments",
             "railId": "payment/f0546026-6711-4ed5-9c73-b41c012b2b71",
             "amount": "5",
             "currency": "usd",
             "clientIdentifier": null,
             "description": "CardPayments from Account 144235477557 to Card 8db749e2-830d-473b-bc38-b6a7f5dbc75a",
             "proposedAt": "03/29/2026 14:09:14",
             "executedAt": "03/29/2026 14:09:14",
             "schedule": ""
         }
     ]
  }