Hacer un cargo o cargo diferido
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v1/charges
Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☑ Aggregator
token entregado por Kushki que representa la tarjeta de crédito del cliente.Para Acquiring
Ejemplo: Credit Type 03 (Cuotas Comercio de Chile)
⚠️ Funcionalidad en Beta La implementación de "Cuotas Comercio" (Credit Type 03) para Chile está en fase Beta. La estructura de datos y la lógica pueden cambiar sin aviso previo durante este periodo.
"deferred": {
"graceMonths": "00",
"creditType": "03",
"months": 3
}¿Tienes tu propio motor de autenticación 3DS?*
threeDomainSecure en tu request.Time out del endpoint: 29 s
¿Tienes tu propio motor de suscripciones?*
Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator
1.
initialRecurrence en el parámetro transactionMode.2.
3.
4.
subsequentRecurrence en el parámetro transactionMode.5.
initialRecurrenceReference (revisa el ejemplo llamado Subsequent recurrence charge for subscriptions)Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/card/v1/charges' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "24e5cc0d47fc4b2ab098bdb7d0b94569",
"amount": {
"currency": "CLP",
"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": "Catalina",
"lastName": "Fuentes",
"email": "user@example.com",
"documentType": "RUT",
"documentNumber": "ABCD123456EF",
"phoneNumber": "+56912345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "Catalina Fuentes",
"phone": "+56912345678",
"city": "Santiago",
"region": "Región Metropolitana",
"country": "Chile",
"address1": "Centro 123"
},
"billingDetails": {
"name": "Catalina Fuentes",
"phone": "+56912345678",
"city": "Santiago",
"region": "Región Metropolitana",
"country": "Chile",
"address1": "Centro 123"
}
},
"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
}
}'Response Response Example
201 - Without fullResponse
{
"ticketNumber": "922513792073660814",
"transactionReference": "6f16659e-b711-4995-a9ae-161aecbd6521"
}Modified at 2026-09-11 15:08:00