Crear pago (sin token)
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v2/charges
Limitaciones
México
deferred, que lleva creditType, graceMonths y months.creditType. Ten en cuenta que el creditType exacto que podrás usar para transacciones diferidas depende del BIN de la tarjeta de crédito. Puedes solicitar las opciones de diferido de un BIN específico desde tu frontend con nuestra API o con una de nuestras frontend libraries.¿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 ya 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": "12",
"expiryYear": "25",
"cvv": "123"
},
"amount": {
"subtotalIva": 0,
"subtotalIva0": 10000,
"ice": 0,
"iva": 0,
"currency": "MXN"
},
"isDeferred": false,
"metadata": {
"referencia": "999929"
},
"contactDetails": {
"documentType": "CC",
"documentNumber": "1234567890",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+525512345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+525512345678",
"address1": "Av. Insurgentes Sur 1234",
"city": "Ciudad de México",
"region": "CDMX",
"country": "Mexico"
},
"billingDetails": {
"name": "John Doe",
"phone": "+525512345678",
"address1": "Av. Insurgentes Sur 1234",
"city": "Ciudad de México",
"region": "CDMX",
"country": "Mexico"
}
},
"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": "MXN",
"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-09-11 14:56:51