Push funds
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/payouts/card/v1/pushFunds
paymentType.Producto en versión beta 🔐👨💻
Estamos trabajando en nuestra versión beta. ¡Mantente al tanto de su lanzamiento oficial! También puedes contactar a tu ejecutivo de cuenta para más información.
1.
card directamente y omitir el token.2.
Campos y descripción
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
clientTransactionId | ✅ Requerido | string | un Universally Unique Identifier (UUID) válido |
card | ✅ Requerido (si no envías un token) | object | Contiene los datos del tarjetahabiente. |
card.name | ✅ Requerido (si no envías un token) | string | Nombre completo del tarjetahabiente. |
card.number | ✅ Requerido (si no envías un token) | string | Número de la tarjeta para la transacción de dispersión. |
card.expiryMonth | ✅ Requerido (si no envías un token) | string | Mes de expiración de la tarjeta (formato de 2 dígitos). |
card.expiryYear | ✅ Requerido (si no envías un token) | string | Año de expiración de la tarjeta (formato de 2 dígitos). |
amount | ✅ Requerido | object | Detalle del monto de la transacción. |
amount.currency | ✅ Requerido | string | Moneda de la transacción (valores permitidos:PEN ). |
amount.totalAmount | ✅ Requerido | numeric | Monto total a transferir. |
paymentType | ✅ Requerido | string | Define el tipo de pago ("OG" (Juegos en línea) o "FD"(Dispersión de fondos ). |
fullResponse | ⛔️ Opcional | string | Si lo envías, debe tener el valor "v2". |
metadata | ⛔️ Opcional | object | Datos adicionales clave-valor relacionados con la transacción. |
metadata.key1 | ⛔️ Opcional | string | Clave única para metadata |
recipient | ✅ Requerido | object | Contiene los datos del destinatario. |
recipient.address | ✅ Requerido | string | Dirección del destinatario. |
recipient.city | ✅ Requerido | string | Ciudad del destinatario. |
recipient.zipCode | ✅ Requerido | string | Código postal del destinatario. |
recipient.country | ✅ Requerido | string | País del destinatario. |
webhooks | ⛔️ Opcional | array | Lista de configuraciones de webhook para recibir actualizaciones de la transacción. |
webhooks[].events | ⛔️ Opcional | array | Usa los eventos asociados al medio de pago. Si envías este objeto vacío, se toma la información creada en la solicitud de la transacción.(approvedTransaction, declinedTransaction). |
webhooks[].urls | ⛔️ Opcional | array | Lista de URLs que reciben las llamadas del webhook. |
webhooks[].headers | ⛔️ Opcional | array | Cabeceras personalizadas para las solicitudes del webhook. |
webhooks[].headers[].label | ⛔️ Opcional | string | Etiqueta de la cabecera personalizada. |
webhooks[].headers[].value | ⛔️ Opcional | string | Valor de la cabecera personalizada. |
token | ⛔️ Opcional | string | Lo puedes obtener con la librería Hosted Fields o con el método Get Card Payout Token. Si no cumples con PCI, este token se obtiene con el método requestCardPayoutToken y es indispensable para procesar pagos de forma segura. Si envías el token, el objeto card ya no es obligatorio. |
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/payouts/card/v1/pushFunds' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
"card": {
"name": "John Doe",
"number": "5102589999999913",
"expiryMonth": "08",
"expiryYear": "23"
},
"clientTransactionId": "{{$guid}}",
"amount": {
"currency": "PEN",
"totalAmount": 0.25
},
"fullResponse": "v2",
"paymentType": "FD",
"metadata": {
"key1": "key1"
},
"recipient": {
"address": "Lima Callse S/N",
"city": "Lima",
"country": "PER",
"zipCode": "63368"
}
}'Response Response Example
201 - FullResponse v2
{
"details": {
"amount": {
"currency": "PEN",
"totalAmount": 250
},
"approvalCode": "21324K",
"approvedTransactionAmount": 250,
"binInfo": {
"bank": "PICHINCHA",
"bin": "495703",
"brand": "VISA",
"brandProductCode": "",
"country": "USA",
"type": "credit",
"prepaid": false
},
"clientTransactionId": "7474849895",
"created": 1740693164307,
"merchantId": "20000000100400157000",
"merchantName": "ORIZABA PAYOUTS CARD BRANCH",
"paymentBrand": "VISA",
"responseCode": "00",
"responseText": "Approved and completed successfully",
"transactionId": "951740693164307311",
"transactionReference": "c5a95370-31b4-4d47-8c36-6d187107b7da",
"transactionStatus": "APPROVAL",
"transactionType": "PAYOUT"
},
"ticketNumber": "951740693164307311",
"transactionReference": "c5a95370-31b4-4d47-8c36-6d187107b7da"
}Modified at 2026-09-10 16:11:33