Create payment (tokenless)
POST
/card/v2/charges
DANGER
This is an On-demand service only available for PCI DSS compliance companies.
DANGER
Important Notice about Transactions with BBVA Peru π΅πͺ
Starting January 1, 2025, BBVA Peru only accepts card transactions with dynamic CVV as part of its measures to enhance the security of online transactions.
This functionality is available for the following models:
β Acquirer
β Aggregator
Limitations
Got a suggestion on this documentation? Contact Us.
Mexico
deferred object that has the creditType, graceMonths and months.creditType field. Keep in mind that the exact creditType you will be able to use for deferred transactions depends on the credit card BIN. You can request the deferred options for a specific BIN from your frontend with our API or with one of our frontend libraries.MΓ©xico
Chile, Colombia and Peru
For Acquiring
deferred object that includes the creditType, graceMonths, and months parameters.graceMonths must be sent with the value of 00.| Country | Deferred Payment Type | creditType Value |
|---|---|---|
| Colombia / PerΓΊ | Standard Installments | 01 |
| Chile | Issuer Installments (Cuotas Emisor) | 01 |
| Chile | Merchant Installments (Cuotas Comercio) | 03 |
Example: Credit Type 01 (Colombia, PerΓΊ, and Chile's Issuer Installments)
Β "deferred": {
Β Β "graceMonths": "00",
Β Β "creditType": "01",
Β Β "months": 6
Β }Example: Credit Type 03 (Chile's "Cuotas Comercio" Installments)
β οΈ Beta Feature The implementation of "Cuotas Comercio" (Credit Type 03) for Chile is currently in Beta phase. The data structure and logic are subject to change without prior notice during this period.
Example: Credit Type 03 (Chile's "Cuotas Comercio" Installments)
"deferred": {
"graceMonths": "00",
"creditType": "03",
"months": 3
}
```json
"deferred": {
Β Β "graceMonths": "00",
Β Β "creditType": "03",
Β Β "months": 3
Β }For Aggregator model
months parameter."months": 3,Do you have your own 3DS authentication engine?*
threeDomainSecure object in your request.Do you have your own subscriptions engine?*
1.
initialRecurrence in the transactionMode parameter and process the charge. For this initial transaction, you must send the CVV.2.
3.
subsequentRecurrence in the transactionMode parameter and include the transactionReference number in the initialRecurrenceReference field. Now you can omit the CVV.An alternative option to process external subscriptions is by sending the parameter externalSubscriptionID. Click here for more information.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api-uat.kushkipagos.com/card/v2/charges' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"card": {
"name": "John Doe",
"number": "5311220000122112",
"expiryMonth": "12",
"expiryYear": "25",
"cvv": "123"
},
"amount": {
"subtotalIva": 0,
"subtotalIva0": 10000,
"ice": 0,
"iva": 0,
"currency": "CLP"
},
"isDeferred": false,
"metadata": {
"referencia": "999929"
},
"contactDetails": {
"documentType": "RUT",
"documentNumber": "11111111-1",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+56912345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+56912345678",
"address1": "Av. Reforma 123",
"city": "Santiago",
"region": "Metropolitana",
"country": "Chile",
"address": "Av. Providencia 1234",
"zipCode": "7500000"
},
"billingDetails": {
"name": "John Doe",
"phone": "+56912345678",
"address1": "Av. Reforma 123",
"city": "Santiago",
"region": "Metropolitana",
"country": "Chile",
"address": "Av. Providencia 1234",
"zipCode": "7500000"
}
},
"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": "CLP",
"isDeferred": false
},
"approvalCode": "123456",
"approvedTransactionAmount": 5000,
"binInfo": {
"bank": "Banco de S.A.",
"binCard": "531122",
"cardCountry": "Mexico",
"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-04-15 21:33:57