Yape
Info
- El estado de la compra para Yape será aprobado o rechazado en cuanto envíe la transacción.
Yape
Yape, un sistema de pago por móvil ampliamente adoptado en Perú, ofrece a los ciudadanos una forma cómoda de realizar transacciones a través del teléfono inteligente. Al vincular sin problemas sus cuentas bancarias a la aplicación Yape, los clientes pueden pagar productos y servicios sin esfuerzo.
A diferencia de otros APM en Perú, el flujo de Yape funciona de forma similar a las transacciones con tarjeta. Sin embargo, en lugar de compartir la información de la tarjeta, sólo es necesario proporcionar el número de teléfono y el código de autorización generado por el cliente en la aplicación de Yape.
Flujo de pago
El siguiente diagrama presenta el flujo de pago utilizado para pagar con Yape.
- El cliente selecciona Yape como medio de pago.
- Usted debe mostrar el formulario para capturar el número de celular y el código de autorización.
- El cliente abre la app Yape y genera un nuevo código de autorización.
- El cliente introduce su número de celular y el código de autorización generado previamente.
- Bamboo procesa la transacción y devuelve un estado aprobado o rechazado.
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 → DocumentType | string | No | Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores. |
Customer → DocumentNumber | string | Sí | Número de documento del cliente. |
Customer → PhoneNumber | string | No | Número de teléfono del cliente. Max 9 caracteres |
Customer → Address → Country | string | No | País del cliente. |
Customer → Address → State | string | No | Departamento 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. |
MetaDataIn → phoneNumber | numeric | Sí | Número de celular del usuario de Yape. |
MetaDataIn → otp | numeric | Sí | Código de autorización generado por el usuario de Yape. |
Ejemplo del Request
{
"PaymentMethod": "YAP",
"Order": "CH2023-001",
"Amount": 100,
"Currency": "PEN",
"TargetCountryISO": "PE",
"Customer": {
"FirstName": "Joao",
"LastName": "Silva",
"ReferenceCode": "JS-001",
"PhoneNumber":"936023105"
"DocumentNumber": "12345678901",
"DocumentType": "DNI.PE",
"Email": "joao.silva@example.com",
"Address": {
"Country": "PE",
"City": "Lima",
"State": "SP",
"PostalCode": "01310-200",
"AddressDetail": "Avenida Paulista 1000"
}
},
"MetaDataIn": {
"PaymentExpirationInMinutes": "1440",
"PhoneNumber": "936023105",
"otp": "123456"
}
}Parámetros del Response
Para más información sobre los parámetros del Response, consulte la sección de parámetros de la creación de la compra.
Ejemplo del Response
{
"TransactionId": "79632697147789184",
"Result": "COMPLETED",
"Status": "APPROVED",
"ErrorCode": null,
"ErrorDescription": null,
"Created": "2024-08-07T17:51:54.620",
"AuthorizationDate": "2024-08-07T17:51:56.879",
"AuthorizationCode": "839936",
"Amount": 25000,
"Currency": "PEN",
"Installments": 1,
"TaxableAmount": null,
"Tip": null,
"Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
"MetadataIn": {
"PaymentExpirationInMinutes": "1440",
"phoneNumber": "969929157",
"otp": "557454"
},
"Action": null,
"PaymentMethod": {
"Brand": "Yape",
"CardOwner": null,
"Bin": null,
"IssuerBank": null,
"Type": "BankTransfer",
"Expiration": null,
"Last4": null
}
}