Crear pago (sin token)
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v2/charges
Este es un servicio On-demand disponible solo para empresas con cumplimiento PCI DSS.
Importante
A partir del 1 de enero de 2025, BBVA Perú solo acepta transacciones con tarjeta con CVV dinámico como parte de sus medidas para reforzar la seguridad de las transacciones en línea.
Limitaciones
Cargos diferidos en Perú 🇵🇪
Para adquirencia
deferred, que incluye los parámetros creditType, graceMonths y months.graceMonths debe enviarse con el valor 00.| País | Tipo de pago diferido | Valor de creditType |
|---|
Ejemplo: Credit Type 01 (diferido del emisor en Perú)
"deferred": {
"graceMonths": "00",
"creditType": "01",
"months": 6
}Para el modelo agregador
months."months": 3,¿Tienes tu propio motor de autenticación 3DS?*
threeDomainSecure en tu request.¿Tienes tu propio motor de suscripciones?*
1.
initialRecurrence en el parámetro transactionMode y procesa el cargo. En esta transacción inicial debes enviar el CVV.2.
3.
subsequentRecurrence en el parámetro transactionMode e incluye el número transactionReference en el campo initialRecurrenceReference. Ahora puedes omitir el CVV.Otra opción para procesar suscripciones externas es enviar el parámetro externalSubscriptionID. Haz clic aquí para más información.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/card/v2/charges' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"card": {
"name": "John Doe",
"number": "5311220000122112",
"expiryMonth": "03",
"expiryYear": "30",
"cvv": "123"
},
"amount": {
"subtotalIva": 0,
"subtotalIva0": 10000,
"ice": 0,
"iva": 0,
"currency": "PEN"
},
"isDeferred": false,
"metadata": {
"referencia": "999929"
},
"contactDetails": {
"documentType": "DNI",
"documentNumber": "1234567890",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+51912345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+51912345678",
"address1": "Av. Javier Prado Este 123",
"city": "Lima",
"region": "Lima",
"country": "Peru"
},
"billingDetails": {
"name": "John Doe",
"phone": "+51912345678",
"address1": "Av. Javier Prado Este 123",
"city": "Lima",
"region": "Lima",
"country": "Peru"
}
},
"productDetails": {
"product": [
{
"id": "198952AB",
"title": "eBook Digital Services",
"price": 10000,
"sku": "10101042",
"quantity": 1
}
]
},
"fullResponse": "v2"
}'Response Response Example
201 - Approved with fullResponse
{
"details": {
"amount": {
"subtotalIva": 0,
"subtotalIva0": 5000,
"ice": 0,
"iva": 0,
"currency": "PEN",
"isDeferred": false
},
"approvalCode": "123456",
"approvedTransactionAmount": 5000,
"binInfo": {
"bank": "Banco de S.A.",
"binCard": "531122",
"cardCountry": "Peru",
"lastFourDigits": "2112",
"type": "credit"
},
"cardHolderName": "John Doe",
"created": 1712092118000,
"merchantId": "20000000101835540000",
"merchantName": "CENTRALIZADA NUEVA PRUEBA GOB",
"messageFields": {
"f38": "123456",
"f39": "00",
"f48": {
"s22": {
"se5": "C101"
}
}
},
"paymentBrand": "Mastercard",
"processorBankName": "Kushki",
"recap": "409321136945",
"requestAmount": 5000,
"responseCode": "000",
"responseText": "Approved or completed successfully.",
"transactionId": "821712092118240856443",
"transactionReference": "3d0d7e1f-02b5-46fa-9791-92722f42df5b",
"transactionStatus": "APPROVAL",
"transactionType": "SALE"
},
"ticketNumber": "821712092118240271",
"transactionReference": "3d0d7e1f-02b5-46fa-9791-92722f42df5b"
}Modified at 2026-09-11 14:52:53