SPEI
Info
El estado de la compra para pagos con SPEI permanecerá en Pending hasta que el cliente complete el pago a través de banca en línea o aplicación de banca móvil.
Transferencia Bancaria (SPEI)
El SPEI (Sistema de Pagos Electrónicos Interbancarios) es un sistema de pagos electrónicos en México que permite a sus clientes transferir fondos entre bancos al instante.
Para utilizar SPEI, los clientes deben tener acceso a la banca en línea o a una aplicación de banca móvil ofrecida por su banco y luego iniciar una transferencia proporcionando el número CLABE (Clave Bancaria Estandarizada) retornado en el response.
Parámetros del Request
Es necesario incluir campos específicos para que este método de pago funcione correctamente. Consulte el artículo operación de compra para obtener información detallada sobre la autenticación, los idiomas de la respuesta y los parámetros de compra básica como el monto y la moneda.
| Propiedad | Tipo | ¿Obligatorio? | Descripción |
|---|---|---|---|
PaymentMethod | string | Sí | Consulta el identificador en la tabla de Medios de pago. |
TargetCountryISO | string | Sí | Indica el país destino. |
Customer → Email | string | Sí | Correo electrónico del cliente. |
Customer → FirstName | string | No | Nombre del cliente. |
Customer → LastName | string | No | Apellido del cliente. |
Customer → DocumentNumber | string | No | Número de documento del cliente. |
Customer → PhoneNumber | string | No | Número de teléfono del cliente. |
Customer → Address → Country | string | No | País del cliente. |
Customer → Address → State | string | No | Estado del cliente. |
Customer → Address → City | string | No | Ciudad del cliente. |
Customer → Address → AddressDetail | string | No | Detalle de la dirección del cliente. |
Customer → Address → PostalCode | string | No | Código postal del cliente. |
MetaDataIn → PaymentExpirationInMinutes | numeric | No | Configure el tiempo de expiración del pago a través de este campo, especificando la duración en minutos. Si no envía este campo, la API asignará un valor por defecto. El tiempo máximo permitido es de 30 días (43200 minutos). |
Ejemplo del Request
{
"PaymentMethod": "SPE",
"Amount": 1000,
"TargetCountryISO": "MX",
"Currency": "MXN",
"Customer": {
"Email": "lucia@test.com",
"FirstName": "Lucia",
"LastName": "Perez",
"PhoneNumber": "525532100000",
"Address": {
"Country": "Mexico",
"State": "Ciudad de Mexico",
"City": "Coyoacan",
"AddressDetail": "Av Universidad 3000"
}
},
"MetaDataIn": {
"PaymentExpirationInMinutes": "7200"
}
}Parámetros del Response
En el Response, encontrará los siguientes parámetros. Puede utilizarlos para crear su propia página de confirmación o utilizar el cupón devuelto en la respuesta:
| Propiedad | Tipo | Descripción |
|---|---|---|
Response → MetadataOut → Clabe | string | Corresponde al número CLABE de la cuenta a la que se enviarán los fondos. Este número es dinámico y único por transacción. |
Response → MetadataOut → Expiration | date | Fecha y hora de expiración del pago. |
Response → MetadataOut → Amount | numeric | Cantidad que debe introducir el pagador al efectuar el pago. |
Response → MetadataOut → BankBeneficiaryName | string | Nombre del dueño de la cuenta del número CLABE |
Response → MetadataOut → BankConcept | string | ID del dueño de la cuenta del número CLABE |
Response → MetadataOut → BankReference | string | ID del dueño de la cuenta del número CLABE |
Response → MetadataOut → PaymentCouponUrl | string | URL del cupon de pago. |
Nota
El número CLABE en el Response pertenece a Bamboo Payment Systems, su cliente debe configurar una transferencia electrónica a este número desde su aplicación bancaria.
Ejemplo del Response
{
"TransactionId": "128598955264065792",
"Result": "COMPLETED",
"Status": "PENDING",
"ErrorCode": null,
"ErrorDescription": null,
"Created": "2024-12-20T20:46:20.199",
"AuthorizationDate": "2024-12-20T20:46:20.674",
"AuthorizationCode": "",
"Amount": 1000,
"Currency": "MXN",
"Installments": 1,
"TaxableAmount": null,
"Tip": null,
"Url": "https://api.bamboopayment.com/Purchase/128598955264065792",
"MetadataOut": {
"Clabe": "646180366608261696",
"Expiration": "25/12/2024 20:46:20",
"Amount": "10.0",
"BankBeneficiaryName": "Bamboo Payment Mexico SRL DE CV",
"BankName": "STP",
"BankConcept": "128598955264065792",
"BankReference": "128598955264065792"
},
"Action": null,
"PaymentMethod": {
"Brand": "STP",
"CardOwner": null,
"Bin": null,
"IssuerBank": null,
"Type": "BankTransfer",
"Expiration": null,
"Last4": null
}
}Experiencia de pago para los clientes
Su cliente debe completar el pago creando una transferencia bancaria al número CLABE retornado en la respuesta. Su cliente debe seguir los siguientes pasos para realizar la transferencia en su app bancaria.
Ingresar a la Plataforma bancaria
Su cliente debe iniciar sesión en su plataforma de banca en línea para iniciar la transferencia única.Seleccionar la opción de transferencia
Su cliente debe navegar hasta la opción para realizar una transferencia o pago. Las plataformas bancarias suelen denominar esta opción como Transferencias o un término similar.Ingresar los datos del destinatario
Se debe informar el número de CLABE en la respuesta, y su cliente debe proporcionarlo en los datos del destinatario. Recuerde que su cliente debe ingresar información precisa para evitar cualquier problema con la transferencia.Especificar monto de la transferencia
Su cliente debe introducir el monto de la compra. Algunas plataformas pueden pedir el tipo de divisa si su cliente tiene cuentas con varias divisas.
¡Importante!
La transferencia debe coincidir con el monto de la compra. De lo contrario, Bamboo rechazará la transacción.
Revisar y confirmar
Recuérdele a su cliente que revise cuidadosamente toda la información introducida para garantizar su exactitud. Su cliente debe comprobar el número de CLABE y el monto de la transferencia. Además, confirmar que tenga fondos suficientes en su cuenta.Autorizar la transferencia
Si es necesario, el sistema puede pedirle a su cliente que autorice la transferencia utilizando una medida de seguridad como contraseña, NIP o autenticación de dos factores.Confirmación de la Transferencia
Su cliente recibirá un mensaje de confirmación una vez que la transferencia haya sido aprobada y procesada. Esta confirmación puede incluir un número de referencia de la transacción que pueden utilizar con fines de seguimiento.
Es importante tener en cuenta que los pasos y opciones específicos pueden variar ligeramente según el banco y la plataforma de banca electrónica que utilice su cliente. Consulte siempre las instrucciones del banco del cliente y siga sus protocolos de seguridad para garantizar una transferencia segura y satisfactoria.
