Enviar SPEI (cash-out)

curl --request POST \ --url https://sandbox.ntxpay.com/api/spei/cash-out \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "amountCentavos": 50000, "destinationClabe": "012180001234567890", "beneficiaryName": "Maria Lopez", "beneficiaryTaxId": "LOMA850101ABC", "concept": "Pago factura 123", "amount": "500.00", "receiverClabe": "012180001234567890", "receiverName": "Maria Lopez", "bankCode": "002", "conciliationId": "payout_001", "externalId": "payout-001" } '

{ "id": 56789, "status": "PENDING", "destinationClabe": "012180001234567890", "amountCentavos": 50000, "referenceNumerical": "9876543", "createdAt": "2026-05-13T12:00:00.000Z", "conciliationId": "payout_001" }

Autorizações

Authorization

string

header

obrigatório

JWT obtido em POST /api/auth/token

Corpo

application/json

amountCentavos

integer

Valor em centavos MXN (mín. 1). Use ESTE campo OU amount.

Intervalo obrigatório: x >= 1

Exemplo:

50000

destinationClabe

string

CLABE destino. 18 dígitos (CLABE bancária) ou 16 dígitos (cartão de débito). Use ESTE OU receiverClabe.

Pattern: ^(\d{18}|\d{16})$

Exemplo:

"012180001234567890"

beneficiaryName

string

Required string length: 3 - 255

Exemplo:

"Maria Lopez"

beneficiaryTaxId

string

RFC/CURP (opcional)

Required string length: 10 - 20

Exemplo:

"LOMA850101ABC"

concept

string

Conceito/descrição (aparece para o beneficiário)

Required string length: 1 - 255

Exemplo:

"Pago factura 123"

amount

string

Alias Voluti — valor como string "100.00".

Pattern: ^\d+\.\d{2}$

Exemplo:

"500.00"

receiverClabe

string

Alias Voluti de destinationClabe.

Pattern: ^(\d{18}|\d{16})$

Exemplo:

"012180001234567890"

receiverName

string

Alias Voluti de beneficiaryName.

Maximum string length: 255

Exemplo:

"Maria Lopez"

bankCode

string

Alias Voluti — código do banco. Aceito e ignorado (a CLABE já contém o ISPB).

Exemplo:

"002"

conciliationId

string

Alias Voluti de externalId.

Maximum string length: 100

Pattern: ^[a-zA-Z0-9_]+$

Exemplo:

"payout_001"

externalId

string

Identificador externo / referência do cliente.

Maximum string length: 100

Exemplo:

"payout-001"

Resposta

Cash-out aceito

integer

Exemplo:

56789

status

enum<string>

Opções disponíveis:

PENDING,

CONFIRMED,

FAILED

Exemplo:

"PENDING"

destinationClabe

string

Exemplo:

"012180001234567890"

amountCentavos

integer

Exemplo:

50000

referenceNumerical

string | null

Exemplo:

"9876543"

createdAt

string<date-time> | null

Exemplo:

"2026-05-13T12:00:00.000Z"

conciliationId

string | null

Alias Voluti — espelha externalId recebido na requisição.

Exemplo:

"payout_001"