--- title: Webhook events: Checks slug: apis/payments/checks/webhook-events-checks description: Receive check-related events (e.g. deposit sent, rejected) via registered webhook callbacks. 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 common `checks` webhook events that are described in detail below. | Event Name | Description | Related endpoints | | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | [Check.Payment.Sent](docId\:cWUBvaS0BDIfokyxu5LhQ) | A check deposit has been sent to the Federal Reserve for clearing | [Deposit check](docId\:xEOwz2w0C2wFSR3tV8mdy) | | [Check.PrintedPayment.Submitted](docId\:cWUBvaS0BDIfokyxu5LhQ) | A check has been sent for printing and delivery | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | | [Check.PrintedPayment.Sent](docId\:cWUBvaS0BDIfokyxu5LhQ) | The printed check was sent | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | | `Check.PrintedPayment.Failed` | Submission of the check for printing failed | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | | [Check.PrintedPayment.Returned](docId\:cWUBvaS0BDIfokyxu5LhQ) | The check that was mailed was not delivered and was returned to sender | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | | [Check.PrintedPayment.Canceled](docId\:cWUBvaS0BDIfokyxu5LhQ) | Check printing was canceled and the check will not be sent | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | | [Check.Payment.Received](docId\:cWUBvaS0BDIfokyxu5LhQ) | 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](docId\:xEOwz2w0C2wFSR3tV8mdy) | | [Check.Payment.Rejected](docId\:cWUBvaS0BDIfokyxu5LhQ) | Outbound check could not be processed due to compliance reasons or was rejected by the Federal Reserve | [Deposit check](docId\:xEOwz2w0C2wFSR3tV8mdy) | | [Check.PositivePay.Created](docId\:cWUBvaS0BDIfokyxu5LhQ) | Incoming check authorized for Positive Pay | [Authorize check](docId\:touxH7X9EeSpTKw6VXI4l) | | [Check.PositivePay.Revoked](docId\:cWUBvaS0BDIfokyxu5LhQ) | Incoming check's Positive Pay status revoked | [Revoke authorization](docId\:YGpxhOjsGdGgo24Udz8lo) | | [Core.Transaction.Completed (inbound forward)](docId\:cWUBvaS0BDIfokyxu5LhQ) | Transaction completed successfully for an incoming check | | | [Core.Transaction.Completed (outbound return)](docId\:cWUBvaS0BDIfokyxu5LhQ) | Transaction completed for simulated inbound return | [Simulate inbound check return](docId\:RTk-hNjDYEP4Uma9yv1vq) | | | Transaction completed for print check | [Print check payment](docId:2w_y2m0a0W0ol8Y05TGIG) | ## Event examples ### Check.Payment.Sent :::CodeblockTabs Sample Event ```curl { "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 :::CodeblockTabs Sample event ```json { "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 :::CodeblockTabs Sample event ```json { "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 :::CodeblockTabs Sample event ```json { "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 :::CodeblockTabs Sample event ```json { "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](docId\:cWUBvaS0BDIfokyxu5LhQ) event. :::CodeblockTabs Sample Event ```curl { "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 :::CodeblockTabs Sample Event ```curl { "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 :::CodeblockTabs Sample event ```curl { "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 :::CodeblockTabs Sample Event ```curl { "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**. :::CodeblockTabs Sample Event ```curl { "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**. :::CodeblockTabs Sample event ```json { "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](docId\:cWUBvaS0BDIfokyxu5LhQ) fires when the check is presented for payment. The `transactionId ` in this event is the same as the `printedPaymentId`. :::CodeblockTabs Sample event ```json { "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": "" } ] } ``` :::