---
title: Webhook events: COS Card payments
slug: apis/webhooks/cos-card-payments/webhook-events-cos-card-payments
description: Receive real-time notifications for events like card authorization, transaction status changes, and account credits via webhooks.
docTags: 
createdAt: 2025-04-21T10:37:44.576Z
---

## Common events

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

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

| Event Name                                                     | Description                                          |
| -------------------------------------------------------------- | ---------------------------------------------------- |
| [CardPayments.Card.Approved](docId\:wso2E9CMh8zs8PyIjC-7r)     | When a card token authorization is approved          |
| [CardPayments.Card.Rejected](docId\:wso2E9CMh8zs8PyIjC-7r)     | When a card token authorization is rejected          |
| [CardPayments.Payment.Cleared](docId\:wso2E9CMh8zs8PyIjC-7r)   | When a payment passes hold evaluations.              |
| [CardPayments.Payment.Completed](docId\:wso2E9CMh8zs8PyIjC-7r) | When a payment transaction is successfully completed |
| [CardPayments.Payment.Rejected](docId\:wso2E9CMh8zs8PyIjC-7r)  | When a payment transaction is rejected               |
| [CardPayments.Payment.Failed](docId\:wso2E9CMh8zs8PyIjC-7r)    | When a payment fails to submit                       |
| [Core.Transaction.Completed](docId\:wso2E9CMh8zs8PyIjC-7r)     | When a payment transaction is successfully completed |

## Event examples

### CardPayments.Card.Approved

:::CodeblockTabs
CardPayments.Card.Approved

```curl
"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

:::CodeblockTabs
CardPayments.Card.Rejected

```curl
"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

:::CodeblockTabs
CardPayments.Card.Complete

```curl
"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

:::CodeblockTabs
CardPayments.Payment.Complete

```curl
"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

:::CodeblockTabs
CardPayments.Payment.Cleared

```curl
"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

:::CodeblockTabs
CardPayments.Payment.Failed

```curl
"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

:::CodeblockTabs
Core.Transaction.Completed

```text
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": ""
         }
     ]
  }

 
```
:::