Tarjeta SPEI® Out
Este método permite realizar una transferencia SPEI® utilizando una tarjeta.
Solicitud HTTP
POST /spei/cards
Parámetros del cuerpo
Parámetro | Tipo | Patrón | Descripción |
---|---|---|---|
payment_concept requerido | cadena | 1-40 caracteres | Concepto de pago por transferencia SPEI®. |
beneficiary_account requerido | cadena | 10, 16 o 18 dígitos | Cuenta del beneficiario, puede ser teléfono, número de tarjeta o CLABE. |
beneficiary_institution requerida | cadena | Instituciones SPEI | Institución bancaria del beneficiario. |
amount requerida | flotante | dígitos | La cantidad a transferir. |
beneficiary_name requerido | cadena | 1-40 caracteres | Nombre del titular de la cuenta del beneficiario. |
numeric_reference requerida | cadena | 1-7 dígitos | Referencia numérica para el pago. |
beneficiary_rfc_curp requerido | cadena | 'ND', 10-13 o 18 caracteres | RFC o CURP del beneficiario. Si no lo conoce, utilice la cadena 'ND'. |
beneficiary_email requerido | cadena | correo electrónico | Correo electrónico del beneficiario. |
pin requerido | cadena | 4-6 dígitos | PIN de seguridad para la operación. |
Nota
*Si el card_number se envía con 16 dígitos, debe enviarse cifrado y codificado en Base 64. Consulte Codificación y cifrado de datos .
Ejemplo de solicitud JSON:
{
"payment_concept": "Pago de servicios",
"beneficiary_account": "123456789012345678",
"beneficiary_institution": "40012",
"amount": 1500.00,
"beneficiary_name": "Juan Pérez",
"numeric_reference": "1234567",
"beneficiary_rfc_curp": "JUAP800101HDFNRN09",
"beneficiary_email": "[email protected]",
"pin": "1234"
}
Ejemplo de respuesta JSON:
{
"success": true,
"code": 0,
"message": "Operación SPEI® Out exitosa.",
"data": {
"card": {
"card_id": "11111111-daa7-1234-aaaa-123123123ecd",
"card_type": "PHISYCAL",
"masked_card_number": "************1234",
"last_four": "1234"
},
"account": {
"account_id": "22222222-daa7-1234-aaaa-123123123ecd",
"rfc": "XAXX010101000",
"curp": "XEXX010101HNEXXXA4",
"primary_phone": "5555555555",
"mobile_phone": "5555555555",
"observations": ""
},
"spei": {
"id": "123456",
"tracking_key": "ABM123456789",
"operation_date": "2021-01-01",
"reference_operation": "ab123456-1qq2-1234-tt5g-8873fe52bf54",
"amount": 3000.25,
"commission": 5.80,
"commission_type": "FLAT",
"iva": 0.93
}
}
}