Skip to main content
POST
/
api
/
spei
/
cash-out
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"
}

Authorizations

​
Authorization
string
header
required

JWT obtido em POST /api/auth/token

Body

application/json
​
amountCentavos
integer

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

Required range: x >= 1
Example:

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})$
Example:

"012180001234567890"

​
beneficiaryName
string
Required string length: 3 - 255
Example:

"Maria Lopez"

​
beneficiaryTaxId
string

RFC/CURP (opcional)

Required string length: 10 - 20
Example:

"LOMA850101ABC"

​
concept
string

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

Required string length: 1 - 255
Example:

"Pago factura 123"

​
amount
string

Alias Voluti — valor como string "100.00".

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

"500.00"

​
receiverClabe
string

Alias Voluti de destinationClabe.

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

"012180001234567890"

​
receiverName
string

Alias Voluti de beneficiaryName.

Maximum string length: 255
Example:

"Maria Lopez"

​
bankCode
string

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

Example:

"002"

​
conciliationId
string

Alias Voluti de externalId.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9_]+$
Example:

"payout_001"

​
externalId
string

Identificador externo / referência do cliente.

Maximum string length: 100
Example:

"payout-001"

Response

Cash-out aceito

​
id
integer
Example:

56789

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

"PENDING"

​
destinationClabe
string
Example:

"012180001234567890"

​
amountCentavos
integer
Example:

50000

​
referenceNumerical
string | null
Example:

"9876543"

​
createdAt
string<date-time> | null
Example:

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

​
conciliationId
string | null

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

Example:

"payout_001"