Criar cobrança OXXO (cash-in)

curl --request POST \ --url https://sandbox.ntxpay.com/api/oxxo/cash-in \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "amountCentavos": 20000, "customerName": "Juan Perez", "customerTaxId": "PEPJ800101ABC", "externalId": "order-xyz-789" } '

{ "id": 33333, "status": "PENDING", "barcode": "012345678901234567", "referenceNumerical": "12345-67890", "checkoutUrl": "https://pay.ntxpay.com/oxxo/abc", "expiresAt": "2026-05-20T23:59:59.000Z", "amountCentavos": 20000 }

Autorizaciones

Authorization

string

header

requerido

JWT obtido em POST /api/auth/token

Cuerpo

application/json

amountCentavos

integer

requerido

Rango requerido: x >= 1

Ejemplo:

20000

customerName

string

requerido

Required string length: 3 - 255

Ejemplo:

"Juan Perez"

customerTaxId

string

RFC/CURP (opcional)

Required string length: 10 - 20

Ejemplo:

"PEPJ800101ABC"

externalId

string

Required string length: 1 - 100

Ejemplo:

"order-xyz-789"

Respuesta

Cobrança OXXO criada (PENDING)

integer

Ejemplo:

33333

status

enum<string>

Opciones disponibles:

PENDING,

CONFIRMED,

EXPIRED

Ejemplo:

"PENDING"

barcode

string | null

Código de barras OXXO para pagamento no caixa

Ejemplo:

"012345678901234567"

referenceNumerical

string | null

Referência numérica OXXO

Ejemplo:

"12345-67890"

checkoutUrl

string<uri> | null

URL do cupom imprimível

Ejemplo:

"https://pay.ntxpay.com/oxxo/abc"

expiresAt

string<date-time> | null

Ejemplo:

"2026-05-20T23:59:59.000Z"

amountCentavos

integer

Ejemplo:

20000