Skip to main content

CoDi Push Notification Payment Received

This webhook is triggered when a CoDi push notification payment is completed.

Payload​

{
"amount": "number",
"apiKeyId": "string",
"bankAccountId": "string",
"concept": "string",
"datePaid": "number",
"metadata": "object",
"numRef": "string",
"transactionId": "string",
"type": "codi.pn.payment_received"
}

Fields​

FieldTypeDescription
amountnumberThe payment amount in MXN (Mexican Peso)
apiKeyIdstringThe API key ID associated with this webhook
bankAccountIdstringPey identifier (ULID) of the bank account that received the payment. Only present when bankAccountId was sent when creating the push notification. See Get Bank Account
conceptstringThe concept shown to the payer
datePaidnumberUnix timestamp in seconds of when the payment was completed
metadataobjectAdditional information about the transaction. See Metadata Response
numRefstringThe reference number assigned to Banxico
transactionIdstringThe unique identifier (ULID) of the transaction
typestringThe event type (codi.pn.payment_received)

Example​

{
"amount": 100,
"apiKeyId": "01M3QMMR6X9CBVDY1SF3G8QWNW",
"bankAccountId": "01JBAVWE4NS5TGXHWGMX3KH23Q",
"concept": "(dev) Order 45",
"datePaid": 1790724758,
"metadata": {
"clabe": "000000000000000000",
"bankCode": 40012,
"accountType": 40,
"description": "(dev) Order 45",
"trackingKey": "0192191042",
"externalMetadata": {
"orderId": "12345",
"customerEmail": "customer@example.com"
}
},
"numRef": "4567",
"transactionId": "01M3QR5E7XHXMNZDEPFH3JAWS0",
"type": "codi.pn.payment_received"
}