API de Generación de Descriptores de Operaciones (v1.0)
La API Generadora de Descriptores de Operación (versión 1.0) de Khipu permite a los comercios crear un identificador único de operación junto con un descriptor cifrado para iniciar transferencias bancarias. A través de un único endpoint (POST /v1/descriptor/payment), se envía el ID del banco de origen y los detalles de la transacción, como monto, moneda, datos del pagador y cuenta de destino. Si la solicitud es exitosa, la API devuelve un objeto JSON con un operation.id (UUID) y un operation.description, que es un descriptor cifrado en Base64, diseñado para ser utilizado en flujos seguros de transferencia bancaria. La autenticación se realiza mediante la cabecera x-api-key.
https://api.khipu.com/
Parametros necesarios para crear un nuevo descriptor de operación.
El nombre del banco del destinatario de la transferencia.
Un alias para la nueva cuenta en caso de que sea la primera transferencia.
- Production
https://api.khipu.com/v1/descriptor/payment
- curl
- Node.js
- Python
- PHP
- Java
- C#
- Go
- Ruby
- JavaScript
- Java8+Apache
curl -i -X POST \
https://api.khipu.com/v1/descriptor/payment \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"bank": "dSXgfesd",
"params": {}
}'Operación exitosa. Retorna un objeto JSON con un nuevo identificador de operación y el descriptor encriptado.
El descriptor cifrado a enviar codificado en Base64.
{ "operation": { "id": "13a0f1aa-5e47-4894-aa8b-282dd19593ec", "description": "eyJtIjoicVlvQU92VllMWm5NVDg2UEovNjNJcGFtRnFQUUNDY lNDcHZBZ283OFNlM01VWVBJZU1sZk05a0NzSWVwRkJPcnZlbG FwSCtaS3pCRmd3YTBybkVKamtaV3gxYm1iTjd2ZzhhNGtuV1N FV3BwclhtVHBkcXRQRXlsVHlhSGtsdTdYTkRtVHZadzlGZlox NFgvRDI3dDFvVkFaVWdKN2JqcXdOQXdsYUM0ZmZSL2xmQzJiR C9kVElJcGtJc0NTVGxDS1YyTThsbDNYV1dUZFFwdXlzN0xiNU FvNVRvVW54NlB0V0Zzd2hxQkVEVmdUWXRhclFqdFBNbUFvRzQ 1akdKdUk2cmhDU25taG9weEVFM0YwOVgzY0hHSDZzSzVsMl==" } }