API de Autorización con Yape
Request
Objeto method_details para Yape que se encuentra dentro de la trama de autorización: API de Autorizacion.
Field | Description | Accepted Value | Type | Obligatorio |
|---|---|---|---|---|
| URL donde se realizará la notificacion host to host (server to server) | Cadena alfanumérica |
| NO |
| Objeto que contiene información del titular de Yape |
| SI | |
| Código del pais del teléfono | Cadena alfanumérica |
| SI |
| Numero del teléfono | Cadena numérica |
| SI |
| Código OTP de la Billetera Yape | Cadena numérica |
| SI |
Ejemplo
{
"action": "authorize",
"channel": "ecommerce",
"merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
"merchant_operation_number": "5974484",
"payment_method": {
"method_name": "YAPE",
"method_details": {
"callback_url": "https://pay-me.com/callback",
"phone": {
"country_code": "+51",
"subscriber": "969929157"
},
"otp": "557454"
}
},
"payment_details": {
"amount": "15000",
"currency": "604",
"billing": {
"first_name": "Pedro",
"last_name": "Miranda",
"email": "pedro@pay-me.com",
"phone": {
"country_code": "+51",
"subscriber": "999835685"
},
"location": {
"line_1": "Av. Casimiro Ulloa 333",
"line_2": "Miraflores",
"city": "Lima",
"state": "Lima",
"country": "Peru"
}
},
"shipping": {
"first_name": "Pedro",
"last_name": "Miranda",
"email": "pedro@pay-me.com",
"phone": {
"country_code": "+51",
"subscriber": "999835685"
},
"location": {
"line_1": "Av. Casimiro Ulloa 333",
"line_2": "Miraflores",
"city": "Lima",
"state": "Lima",
"country": "Peru"
}
},
"customer": {
"first_name": "Pedro",
"last_name": "Miranda",
"email": "pedro@pay-me.com",
"phone": {
"country_code": "+51",
"subscriber": "999835685"
},
"location": {
"line_1": "Av. Casimiro Ulloa 333",
"line_2": "Miraflores",
"city": "Lima",
"state": "Lima",
"country": "Peru"
}
},
"product_details": []
}
}
}Response
Objeto transaction para pagos con YAPE que se encuentra dentro de la trama de respuesta: API de Autorizacion.
Field | Description | Accepted Value | Type | Obligatorio |
|---|---|---|---|---|
| Identificador unico de la transacción | Cadena alfanumérica |
| SI |
| Canal por la cual se realizó la transacción |
|
| SI |
| Estado actual de la transacción |
|
| SI |
| Observacion del estado | SI | ||
| Monto de la transacción | Cadena numérica |
| SI |
| Código de la moneda de la operación | Cadena numérica |
| SI |
| Objeto que contiene información sobre el método de pago usado en la transacción |
|
| SI |
| Nombre del método de pago usado en la transacción |
|
| SI |
| Objeto que contiene información detallada relacionada al método. Este objeto varia por método. |
|
| SI |
| Objeto que contiene información del telefono del cliente Yape |
| SI | |
| Código del Pais del teléfono de Yape | Cadena numérica |
| SI |
| Número de telefono de Yape | Cadena numérica |
| SI |
| Tarjeta enmascarada usada en la transacción | Cadela alfanumérica |
| NO |
| Marca de la tarjeta usada en la transacción | Cadena alfabética |
| NO |
| Bin de la tarjeta usada en la transacción | Cadena numérica |
| NO |
| Ultimos 4 dígitos de la tarjeta usada en la transacción | Cadena numérica |
| NO |
| Tipo de tarjeta | Cadela alfanumérica |
| NO |
| Pais de la tarjeta | Cadela alfanumérica |
| NO |
| Banco emisor de la tarjeta | Cadela alfanumérica |
| NO |
|
Visible en estado AUTORIZADO - DENEGADO - EXTORNADO Objeto que contiene el resultado de la autorización. Los valores son devueltos por la procesadora. |
|
| NO |
| Código de autorización | Cadena alfanumérica |
| NO |
| ID de la transacción ante la marca | Cadena alfanumérica |
| NO |
| Objeto que contiene mensaje del resultado de la autorizacion |
|
| NO |
| Código del resultado de la autorización | Cadena alfanumérica |
| NO |
| Descripción del resultado de la autorización | Cadena alfanumérica |
| NO |
| Objeto que contiene los datos adicionales de la transacción enviados en el request |
|
| NO |
| Array que contiene listado de los estado por la cual pasó la transacción |
|
| SI |
| Estado de la transacción |
|
| SI |
| Objeto que contiene la fecha en la que se realizó el cambio de estado |
|
| SI |
| Fecha en UTC | Cadena alfanumérica |
| SI |
| Fecha en unix time | Cadena alfanumérica |
| SI |
Ejemplo
{
"success": "true",
"action": "authorize",
"merchant_code": "b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
"merchant_operation_number": "2391645",
"transaction": {
"transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
"channel": "ecommerce",
"state": "AUTORIZADO",
"state_reason": "Pago exitoso con Yape"
"amount": "15000",
"currency": "604",
"payment_method": {
"method_name": "YAPE",
"method_details": {
"phone": {
"country_code": "+51",
"subscriber": "969929157"
},
"masked_pan": "411111********1111",
"brand": "VISA",
"bin": "411111",
"last_pan": "9268",
"card_type": "DEBIT",
"card_country": "PE",
"issuer": "BANCO DE CREDITO DEL PERU - BCP",
}
},
"processor_response": {
"authorization_code": "055552",
"brand_transaction_id": "100B",
"result_message": {
"code": "00",
"description": "Approval and completed successfully"
}
},
"additional_fields": null,
"lifecycle": [
{
"state": "REGISTRADO",
"date": {
"utc_time": "2024-03-12T22:49:36.018Z",
"unix_time": 1710282940
}
},
{
"state": "PENDIENTE",
"date": {
"utc_time": "2024-03-12T22:49:36.018Z",
"unix_time": 1710282940
}
},
{
"state": "AUTORIZADO",
"date": {
"utc_time": "2024-03-12T22:49:36.018Z",
"unix_time": 1710282940
}
}
]
},
"meta": {
"status": {
"code": "00",
"message_ilgn": [
{
"locale": "es_PE",
"value": "Procesado correctamente"
}
]
}
}
}