Webhook events: Checks

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 common checks webhook events that are described in detail below.

Event Name	Description	Related endpoints
Check.Payment.Sent	A check deposit has been sent to the Federal Reserve for clearing	Deposit check
Check.PrintedPayment.Submitted	A check has been sent for printing and delivery	Print check payment
Check.PrintedPayment.Sent	The printed check was sent	Print check payment
Check.PrintedPayment.Failed	Submission of the check for printing failed	Print check payment
Check.PrintedPayment.Returned	The check that was mailed was not delivered and was returned to sender	Print check payment
Check.PrintedPayment.Canceled	Check printing was canceled and the check will not be sent	Print check payment
Check.Payment.Received	A check drawn on an account in COS has been deposited at another bank and has been received from the Federal Reserve for posting	Deposit check
Check.Payment.Rejected	Outbound check could not be processed due to compliance reasons or was rejected by the Federal Reserve	Deposit check
Check.PositivePay.Created	Incoming check authorized for Positive Pay	Authorize check
Check.PositivePay.Revoked	Incoming check's Positive Pay status revoked	Revoke authorization
Core.Transaction.Completed (inbound forward)	Transaction completed successfully for an incoming check
Core.Transaction.Completed (outbound return)	Transaction completed for simulated inbound return	Simulate inbound check return
	Transaction completed for print check	Print check payment

Event examples

Check.Payment.Sent

{
  "id": "bfdf9c39-633f-4cf2-be4a-b2e201334528",
  "eventName": "Check.Payment.Sent",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T14:38:44.177+00:00",
  "resources": [
    "checks/v1/payments/9a2975ce-2466-4c4b-87a0-b2e201330da8"
  ],
  "details": [
    {
      "paymentId": "9a2975ce-2466-4c4b-87a0-b2e201330da8",
      "paymentType": "Forward",
      "coreTransactionId": "2ccddeaf-a957-4936-8837-b2e201330da8",
      "memoPostId": "879645d9-ec6e-4ffe-beeb-b2e201330da8",
      "accountNumber": "2207975570",
      "depositBusinessDate": "250519",
      "postingCode": "OK",
      "amount": "15000",
      "recognizedAmount": "100",
      "payerRoutingNumber": "314074269",
      "payerAccountNumber": "28293886",
      "checkNumber": "1237",
      "checkType": "Standard",
      "sequenceNumber": "5894754816",
      "micr": "1237",
      "purpose": "SKIP_IQA",
      "clientIdentifier": null,
      "schedule": "0,15000",
      "policy": "Standard",
      "rejectionReason": null,
      "isRedeposit": "False",
      "originalPaymentId": "9a2975ce-2466-4c4b-87a0-b2e201330da8"
    }
  ]
}

Check.PrintedPayment.Submitted

{
  "id": "519b80ca-4f34-43b1-adfd-b4a200db4f11",
  "eventName": "Check.PrintedPayment.Submitted",
  "status": "Pending",
  "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
  "createdAt": "2026-08-10T09:18:28.743-04:00",
  "resources": [
    "checks/v1/printed-payments/db2c7bbc-abb2-43b4-8889-b4a200db44b9"
  ],
  "details": [
    {
      "transactionId": "db2c7bbc-abb2-43b4-8889-b4a200db44b9",
      "checkNumber": "1002",
      "amount": "50000",
      "status": "Submitted",
      "memo": "Test check print",
      "fundingAccountNumber": "2136870751",
      "stubText": null,
      "postageCode": "UspsFirstClass",
      "payeeName": "Frank Wright",
      "clientIdentifier": null
    }
  ]
}

Check.PrintedPayment.Sent

{
  "id": "e184494e-1103-4b9e-835b-b4a201003c02",
  "eventName": "Check.PrintedPayment.Sent",
  "status": "Pending",
  "partnerId": "a3b921b9-f892-4b5a-9330-b41000fc29ad",
  "createdAt": "2026-08-10T11:32:55.26-04:00",
  "resources": [
    "checks/v1/printed-payments/a9f09ef1-b399-4630-9bb8-b4a200ff0934"
  ],
  "details": [
    {
      "transactionId": "a9f09ef1-b399-4630-9bb8-b4a200ff0934",
      "checkNumber": "1000",
      "amount": "1313",
      "status": "Mailed",
      "memo": "testing print check",
      "fundingAccountNumber": "169726919452",
      "stubText": "",
      "postageCode": "UspsFirstClass",
      "payeeName": "Jon West",
      "clientIdentifier": "test1 check"
    }
  ]
}

Check.PrintedPayment.Returned

{
  "id": "2b57ddc9-f6b8-4e51-9d15-b4a201008233",
  "eventName": "Check.PrintedPayment.Returned",
  "status": "Pending",
  "partnerId": "a3b921b9-f892-4b5a-9330-b41000fc29ad",
  "createdAt": "2026-08-10T11:33:55.143-04:00",
  "resources": [
    "checks/v1/printed-payments/a9f09ef1-b399-4630-9bb8-b4a200ff0934"
  ],
  "details": [
    {
      "transactionId": "a9f09ef1-b399-4630-9bb8-b4a200ff0934",
      "checkNumber": "1000",
      "amount": "1313",
      "status": "Returned",
      "memo": "test print check",
      "fundingAccountNumber": "169726919452",
      "stubText": "",
      "postageCode": "UspsFirstClass",
      "payeeName": "Jon West",
      "clientIdentifier": "test1 check"
    }
  ]
}

Check.PrintedPayment.Canceled

{
  "id": "69bb3264-53db-4a6e-aa85-b4a20100a55a",
  "eventName": "Check.PrintedPayment.Canceled",
  "status": "Pending",
  "partnerId": "a3b921b9-f892-4b5a-9330-b41000fc29ad",
  "createdAt": "2026-08-10T11:34:25.143-04:00",
  "resources": [
    "checks/v1/printed-payments/a9f09ef1-b399-4630-9bb8-b4a200ff0934"
  ],
  "details": [
    {
      "transactionId": "a9f09ef1-b399-4630-9bb8-b4a200ff0934",
      "checkNumber": "1000",
      "amount": "1313",
      "status": "Canceled",
      "memo": "test print check",
      "fundingAccountNumber": "169726919452",
      "stubText": "",
      "postageCode": "UspsFirstClass",
      "payeeName": "Jon West",
      "clientIdentifier": "test1 check"
    }
  ]
}

Check.Payment.Received

The coreTransactionId here is the same as the transactionId, and the paymentId is the same as the railId, in the related Core.Transaction.Completed event.

{
  "id": "d833908c-2248-47bd-b20a-b440010f078f",
  "eventName": "Check.Payment.Received",
  "status": "Pending",
  "partnerId": "ba9d0234-26e9-43a2-9070-aedd0108eadb",
  "createdAt": "2026-05-04T12:26:47.3-04:00",
  "resources": [
    "checks/v1/payments/b5186a19-d6be-424c-b4cf-b440010eed46"
  ],
  "details": [
    {
      "paymentId": "b5186a19-d6be-424c-b4cf-b440010eed46",
      "coreTransactionId": "024ae28e-9f37-4505-a6db-b440010eed46",
      "accountNumber": "105722736391",
      "checkNumber": "1253",
      "bofdRoutingNumber": "061000146",
      "payeeName": "Verizon Wireless",
      "checkType": "Unknown",
      "sequenceNumber": "3762766875",
      "clientIdentifier": null,
      "positivePayResult": null,
      "positivePayMatchId": null,
      "amount": "6999"
    }
  ]
}

Check.Payment.Rejected

{
  "id": "fecaad6b-a2be-40e3-a4ad-b2e20133afcc",
  "eventName": "Check.Payment.Rejected",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T14:40:15.167+00:00",
  "resources": [
    "checks/v1/payments/a0a8c33b-9e30-4356-8c13-b2e201338f14"
  ],
  "details": [
    {
      "paymentId": "a0a8c33b-9e30-4356-8c13-b2e201338f14",
      "paymentType": "Forward",
      "coreTransactionId": "2c951cb5-b9f1-4455-b1b9-b2e201338f14",
      "memoPostId": "79c6727e-2fb8-4d8f-a207-b2e201338f14",
      "accountNumber": "2207975570",
      "depositBusinessDate": "250519",
      "postingCode": "OK",
      "amount": "75000",
      "recognizedAmount": "100",
      "payerRoutingNumber": "314074269",
      "payerAccountNumber": "28293886",
      "checkNumber": "1237",
      "checkType": "Standard",
      "sequenceNumber": "6017013176",
      "micr": "1237",
      "purpose": "SKIP_IQA",
      "clientIdentifier": null,
      "schedule": "0,7500,67500",
      "policy": "Standard",
      "rejectionReason": "NotSpecified",
      "isRedeposit": "False",
      "originalPaymentId": "a0a8c33b-9e30-4356-8c13-b2e201338f14"
    }
  ]
}

Check.PositivePay.Created

{
  "id": "8cdc3968-503b-4097-ad42-b4a200dd4629",
  "eventName": "Check.PositivePay.Created",
  "status": "Pending",
  "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
  "createdAt": "2026-08-10T09:25:38.047-04:00",
  "resources": [
    "checks/v1/positive-pay-authorizations/80131866-a232-4df3-8562-b4a200dd23b3"
  ],
  "details": [
    {
      "positivePayId": "80131866-a232-4df3-8562-b4a200dd23b3",
      "accountNumber": "2640511503",
      "amount": "100000",
      "checkNumber": "1238",
      "payeeName": "John Strong",
      "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
      "productId": "83bed086-8182-4151-a1e3-af5b01362783"
    }
  ]
}

Check.PositivePay.Revoked

{
  "id": "6a78c762-8b8d-42e9-9e4f-b4a200dd8f48",
  "eventName": "Check.PositivePay.Revoked",
  "status": "Pending",
  "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
  "createdAt": "2026-08-10T09:26:40.447-04:00",
  "resources": [
    "checks/v1/positive-pay-authorizations/80131866-a232-4df3-8562-b4a200dd23b3"
  ],
  "details": [
    {
      "positivePayId": "80131866-a232-4df3-8562-b4a200dd23b3",
      "accountNumber": "2640511503",
      "amount": "100000",
      "checkNumber": "1238",
      "payeeName": "John Strong",
      "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
      "productId": "83bed086-8182-4151-a1e3-af5b01362783"
    }
  ]
}

Core.Transaction.Completed (inbound forward)

Note the transactionCode here is Check.

{
  "id": "61bd2058-cd8a-489a-a4ac-b440010f078e",
  "eventName": "Core.Transaction.Completed",
  "status": "Pending",
  "partnerId": "ba9d0234-26e9-43a2-9070-aedd0108eadb",
  "createdAt": "2026-05-04T12:26:47.287-04:00",
  "resources": [
    "core/v1/transactions/024ae28e-9f37-4505-a6db-b440010eed46"
  ],
  "details": [
    {
      "transactionId": "024ae28e-9f37-4505-a6db-b440010eed46",
      "transactionCode": "Check",
      "debitSubAccount": "105722736391",
      "debitMasterAccount": "105722736391",
      "debitResult": "OK",
      "creditSubAccount": "26250000095",
      "creditMasterAccount": "26250000095",
      "creditResult": "OK",
      "rail": "Checks",
      "railId": "payment/b5186a19-d6be-424c-b4cf-b440010eed46",
      "amount": "6999",
      "currency": "usd",
      "clientIdentifier": null,
      "description": "CHECK #1253 REF: C124NP2035YA",
      "proposedAt": "05/04/2026 12:26:24",
      "executedAt": "05/04/2026 12:26:25",
      "schedule": ""
    }
  ]
}

Core.Transaction.Completed (outbound return)

Note the transactionCode here is Reversal.

{
    "id": "b431bf23-0949-48f6-89ff-b48c006d4f12",
    "eventName": "Core.Transaction.Completed",
    "status": "Pending",
    "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
    "createdAt": "2026-07-19T02:37:58.957-04:00",
    "resources": [
        "core/v1/transactions/7153b673-bf50-4b9b-b097-b48c006d4d1f"
    ],
    "details": [
        {
            "transactionId": "7153b673-bf50-4b9b-b097-b48c006d4d1f",
            "transactionCode": "Reversal",
            "debitSubAccount": "2203250853",
            "debitMasterAccount": "2203250853",
            "debitResult": "OK",
            "creditSubAccount": "20020020027",
            "creditMasterAccount": "20020020027",
            "creditResult": "OK",
            "rail": "Checks",
            "railId": "payment/3366874c-b887-4532-aec7-b48c006d4d1f",
            "amount": "10000",
            "currency": "usd",
            "clientIdentifier": null,
            "description": "RETURNED CHECK #1237 REF: C200R1684TDQ",
            "proposedAt": "07/19/2026 02:37:57",
            "executedAt": "07/19/2026 02:37:57",
            "schedule": ""
        }
    ]
}

Core.Transaction.Completed (print check submitted)

Note the transactionCode here is Account Transfer. This indicates that the funds were received from the customer account to the check printing account. A new Core.Transaction.Completed fires when the check is presented for payment.

The transactionId in this event is the same as the printedPaymentId.

{
  "id": "7c0c3709-6feb-44ca-8d94-b4a200db4ef7",
  "eventName": "Core.Transaction.Completed",
  "status": "Pending",
  "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
  "createdAt": "2026-08-10T09:18:28.66-04:00",
  "resources": [
    "core/v1/transactions/db2c7bbc-abb2-43b4-8889-b4a200db44b9"
  ],
  "details": [
    {
      "transactionId": "db2c7bbc-abb2-43b4-8889-b4a200db44b9",
      "transactionCode": "Account Transfer",
      "debitSubAccount": "2136870751",
      "debitMasterAccount": "2136870751",
      "debitResult": "OK",
      "creditSubAccount": "2532597750",
      "creditMasterAccount": "2532597750",
      "creditResult": "OK",
      "rail": "Checks",
      "railId": "printed/db2c7bbc-abb2-43b4-8889-b4a200db44b9",
      "amount": "50000",
      "currency": "usd",
      "clientIdentifier": null,
      "description": "Test check print",
      "proposedAt": "08/10/2026 09:18:19",
      "executedAt": "08/10/2026 09:18:19",
      "schedule": ""
    }
  ]
}