CoDi QR Payment Received

This webhook is triggered when a payment is received on a CoDi QR created via the API.

Payload

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

Fields

Field	Type	Description
amount	number	The amount received in MXN (Mexican Pesos)
apiKeyId	string	The API key ID associated with this webhook
bankAccountId	string	Pey identifier (ULID) of the bank account that received the payment. Only present when bankAccountId was sent when creating the QR. See Get Bank Account
codiQrId	string	The CoDi QR identifier (IDC) assigned by Banxico
concept	string	The concept shown to the payer
datePaid	number	Unix timestamp in seconds of when the payment was completed
metadata	object	Additional information about the transaction. See Metadata Response
numRef	string	The reference number assigned to Banxico
transactionId	string	Unique identifier (ULID) for the transaction
type	string	The event type (codi.qr.payment_received)

Example

{
  "amount": 150,
  "apiKeyId": "01M3QMMR6X9CBVDY1SF3G8QWNW",
  "bankAccountId": "01JBAVWE4NS5TGXHWGMX3KH23Q",
  "codiQrId": "35a13c183a",
  "concept": "(dev) Order 345",
  "datePaid": 1790724818,
  "metadata": {
    "clabe": "000000000000000000",
    "bankCode": 40012,
    "accountType": 40,
    "description": "(dev) Order 345",
    "trackingKey": "0192191042",
    "externalMetadata": {
      "orderId": "12345",
      "customerEmail": "customer@example.com"
    }
  },
  "numRef": "34567",
  "transactionId": "01M3QR8H0RH0XBCKYYD242YXNV",
  "type": "codi.qr.payment_received"
}