Skip to main content
POST
Criar cobrança SPEI (cash-in)

Authorizations

Authorization
string
header
required

JWT obtido em POST /api/auth/token

Body

application/json
amountCentavos
integer
required

Amount in MXN centavos. Minimum 1000 centavos (10.00 MXN) — partner bank floor.

Required range: x >= 1000
Example:

50000

customerName
string
required

Nome do pagador (mostrado no checkout SPEI)

Required string length: 1 - 255
Example:

"Juan Perez"

customerEmail
string<email>
required

Email do pagador

Example:

"juan@example.com"

externalId
string

Identificador externo / referência do cliente.

Required string length: 1 - 100
Example:

"order-abc-123"

description
string
Required string length: 1 - 255
Example:

"Pedido #123"

customerTaxId
string

RFC/CURP do pagador

Required string length: 10 - 20
Example:

"PEPJ800101ABC"

Response

Cobrança SPEI criada (PENDING)

transactionId
string<uuid>

Identificador publico da transacao (UUID). E o mesmo transactionId entregue nos webhooks — use-o para correlacionar e consultar a transacao.

Example:

"3f2a1c34-9d1e-4c7b-8a5e-2b6f0d9c4e71"

status
enum<string>
Available options:
PENDING,
CONFIRMED,
FAILED,
EXPIRED
Example:

"PENDING"

destinationClabe
string

CLABE descartável de destino para o pagador transferir

Example:

"012180001234567890"

beneficiary
object
referenceNumerical
string | null
Example:

"1234567"

checkoutUrl
string<uri> | null
Example:

"https://pay.ntxpay.com/checkout/xyz"

expiresAt
string<date-time> | null
Example:

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

amountCentavos
integer
Example:

50000