Procesar Pago
POST
/paymentInicia el procesamiento de pago para una recarga.
Objetivo
Este webhook permite iniciar una operación de recarga indicando el producto, monto y método de pago.
Request
Headers
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
x-api-key | String | Sí | API Key provista para acceder al endpoint. |
x-authorization-token | String | Sí | Token de autenticación generado en el login. |
Body Parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
companyCode | String | Sí | Código de la compañía de recarga. |
productId | String | Sí | ID del producto de recarga. |
amount | Number | Sí | Monto de la recarga. |
identifierName | String | Sí | Nombre del identificador (ej: BA1, IDC). |
identifierValue | String | Sí | Valor del identificador (ej: número de teléfono). |
paymentMethod | String | Sí | Método de pago utilizado. Valores posibles: DEBIT, ACCOUNT, CREDIT. |
externalPaymentId | String | Sí | ID único de la operación generado por el cliente. |
externalClientId | String | Sí | ID del usuario final asignado por el cliente. |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
operationId | String | ID único de la operación generada. |
createdAt | Datetime | Fecha y hora de creación de la operación. |
companyCode | String | Código de la compañía. |
companyName | String | Nombre de la compañía. |
amount | Number | Monto de la recarga. |
identifiers | Object[] | Identificadores utilizados para la recarga. |
agent | String | Nombre del agente procesador. |
clientUserName | String | Nombre del cliente fintech que realizó la operación. |
externalClientId | String | ID del usuario final asignado por el cliente. |
externalPaymentId | String | ID de la operación provisto por el cliente. |
additionalData | Object | Información adicional relacionada a la operación. |
Consideraciones
- Este servicio inicia una operación de recarga y devuelve su identificador único.
- Si algún campo obligatorio es inválido o falta, se responderá con error 400.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request POST \
--url https://recharge.homo.tapila.cloud/payment \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
"companyCode": "",
"productId": "",
"amount": "",
"identifierName": "",
"identifierValue": "",
"paymentMethod": "",
"externalPaymentId": "",
"externalClientId": ""
}'