Make a charge or deferred charge

Make a charge with a token provided by Kushki which represents the customer's credit card.

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.

Deferred charges in Peru 🇵🇪

For Peru 🇵🇪, deferred transactions vary depending on the affiliation model:

For Acquiring

For deferred charges in Peruvian merchants, you have to set the deferred object that includes the creditType, graceMonths, and months parameters.

In all countries, graceMonths must be sent with the value of 00.

Example: Credit Type `01` (Perú's Issuer Installments)

  "deferred": {
    "graceMonths": "00",
    "creditType": "01",
    "months": 6
  }

For Aggregator model

For deferred charges in Peruvian merchants in aggregator model, you can send the number of installments in the months parameter.

"months": 3,

Important!
In any case, you should consult the request deferred options method as these vary according to the BIN of the card.

Do you have your own 3DS authentication engine?*

Make sure you include the threeDomainSecure object in your request.

* Applies in Peru 🇵🇪.

Endpoint time out: 29 sec

Do you have your own subscriptions engine?*

* Applies in Peru 🇵🇪.

In case you have your own subscriptions engine (only PCI Compliance merchants), you can follow the steps below to process recurring charges:

Obtain a card token by sending initialRecurrence in the transactionMode parameter.

Use the obtained token in step 1 to make an initial charge (see the example named Initial recurrence charge for subscriptions).

Make sure you save the transactionReference number of the charge completed in step 2.

For the subsequent transactions, obtain a card token by sending subsequentRecurrence in the transactionMode parameter.

Make a charge by sending the transactionReference number in the initialRecurrenceReference field (see the example named Subsequent recurrence charge for subscriptions)

curl --location 'https://api-uat.kushkipagos.com/card/v1/charges' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "24e5cc0d47fc4b2ab098bdb7d0b94569", "amount": { "currency": "PEN", "subtotalIva": 0, "subtotalIva0": 5000, "iva": 0, "ice": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0 } }, "metadata": { "key0": "value0", "key1": "value1", "key2": "value2" }, "fullResponse": "v2", "ignoreWarnings": true, "contactDetails": { "firstName": "John", "lastName": "Doe", "email": "user@example.com", "documentType": "DNI", "documentNumber": "ABCD123456EF", "phoneNumber": "+51912345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+51912345678", "address": "Centro 123", "city": "Lima", "region": "Lima", "country": "Peru" }, "billingDetails": { "name": "John Doe", "phone": "+51912345678", "address": "Centro 123", "city": "Lima", "region": "Lima", "country": "Peru" } }, "productDetails": { "product": [ { "id": "198952AB", "title": "eBook Digital Services", "price": 15000, "sku": "10101042", "quantity": 1 } ] }, "threeDomainSecure": { "cavv": "AAABBoVBaZKAR3BkdkFpELpWIiE=", "eci": "07", "specificationVersion": "2.2.0", "acceptRisk": true } }'

Deferred charges in Peru 🇵🇪

For Acquiring

Example: Credit Type `01` (Perú's Issuer Installments)

For Aggregator model

Important!

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*

Request

Responses

Make a charge or deferred charge

Deferred charges in Peru 🇵🇪#

For Acquiring#

Example: Credit Type 01 (Perú's Issuer Installments)#

For Aggregator model#

Important!#

Do you have your own 3DS authentication engine?*#

Do you have your own subscriptions engine?*#

Request

Responses

Deferred charges in Peru 🇵🇪

For Acquiring

Example: Credit Type `01` (Perú's Issuer Installments)

For Aggregator model

Important!

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*