Pagos únicos
Beta
Tipos de cargo
| Tipo | Cómo activarlo |
|---|---|
| Cargo único | transaction_type: "charge", transaction_mode: "Authorization" |
| Cargo diferido | Igual que el anterior, más is_deferred: true y el objeto deferred |
| Cashback | Igual que el cargo único, más is_cashback: true y cashback_amount |
| Propina | Igual que el cargo único, más amount.tip |
Canales de lectura
card_details.reading_type para indicar cómo se leyó la tarjeta.| Valor | Canal |
|---|---|
ICC | Chip (Integrated Circuit Card) |
MCR | Banda magnética |
NFC | Contactless |
card_details (enc_tlv para ICC/NFC; tracks para MCR/NFC).Cargo único
{
"transaction_type": "charge",
"transaction_mode": "Authorization",
"country": "PER",
"client_transaction_id": "a0e1b2c3-d4e5-6789-abcd-ef0123456789",
"amount": {
"currency": "PEN",
"subtotal_iva": 0,
"subtotal_iva0": 150,
"iva": 0,
"tip": 0
},
"card_details": {
"reading_type": "ICC",
"enc_tlv": "<encrypted-tlv>",
"pin_ksn": "<ksn-value>",
"tracks": {
"enc_track2": "<encrypted-track2>",
"track_ksn": "<ksn-value>"
}
},
"cvm_type": "pin",
"contact_details": {
"document_type": "-1",
"document_number": "",
"first_name": "Carlos",
"last_name": "Ramirez"
},
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "1.1.13",
"has_print": true
}
}Cargo diferido
is_deferred: true e incluye el objeto deferred con la cantidad de meses de diferido.{
"transaction_type": "charge",
"transaction_mode": "Authorization",
"country": "PER",
"client_transaction_id": "a0e1b2c3-d4e5-6789-abcd-ef0123456789",
"is_deferred": true,
"deferred": {
"months": "6"
},
"amount": {
"currency": "PEN",
"subtotal_iva": 0,
"subtotal_iva0": 500,
"iva": 0,
"tip": 0
},
"card_details": {
"reading_type": "NFC",
"enc_tlv": "<encrypted-tlv>",
"pin_ksn": "<ksn-value>",
"tracks": {
"enc_track2": "<encrypted-track2>",
"track_ksn": "<ksn-value>"
}
},
"cvm_type": "none",
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "1.1.13",
"has_print": true
}
}Campos del request
Campos de primer nivel
| Campo | Obligatorio | Descripción |
|---|---|---|
transaction_type | Sí | "charge" para un pago único. |
transaction_mode | Sí | "Authorization" para cobrar de inmediato. |
country | Sí | ISO 3166-1 alpha-3. Debe ser "PER". |
client_transaction_id | Sí | UUID v4 generado por el comercio. Debe ser único por transacción. |
is_deferred | No | Ponlo en true para diferir el cargo. |
deferred | No | Obligatorio cuando is_deferred es true. |
is_cashback | No | Ponlo en true para incluir un monto de cashback. |
cashback_amount | No | Obligatorio cuando is_cashback es true. |
cvm_type | Sí | Método de verificación del tarjetahabiente: "none", "pin" o "signature". |
omit_card | No | Ponlo en true para operaciones sin tarjeta. |
metadata | No | Objeto llave-valor con datos adicionales. |
amount
| Campo | Obligatorio | Descripción |
|---|---|---|
currency | Sí | "PEN" o "USD". |
subtotal_iva | Sí | Subtotal afecto a IGV. Ponlo en 0 si no aplica IGV. |
subtotal_iva0 | Sí | Subtotal no afecto a IGV (monto total cuando no hay impuesto). |
iva | Sí | Monto del IGV. Ponlo en 0 si no aplica IGV. |
tip | No | Monto de la propina. |
extra_taxes | No | Impuestos adicionales: airport_tax, iac, ice, travel_agency. |
card_details
| Campo | Obligatorio | Descripción |
|---|---|---|
reading_type | Sí | "ICC", "MCR" o "NFC". |
enc_tlv | No | Datos TLV cifrados (obligatorio para ICC y NFC). |
pin_block | No | PIN block cifrado para transacciones con PIN en línea. |
pin_ksn | No | Key serial number (KSN) del PIN block. |
tracks.enc_track2 | No | Datos del Track 2 cifrados (MCR y NFC). |
tracks.track_ksn | No | KSN del Track 2. |
deferred
| Campo | Obligatorio | Descripción |
|---|---|---|
months | Sí | Cantidad de meses de diferido. |
contact_details
| Campo | Obligatorio | Descripción |
|---|---|---|
document_type | No | -1 — no se envía documento. |
document_number | No | Obligatorio cuando document_type no es -1. |
first_name | No | Nombre del tarjetahabiente. |
last_name | No | Apellido del tarjetahabiente. |
email | No | Correo electrónico del tarjetahabiente. |
phone_number | No | Teléfono del tarjetahabiente (formato E.164). |
pos_details
| Campo | Obligatorio | Descripción |
|---|---|---|
brand | No | Marca de la terminal (por ejemplo, "SUNMI"). |
model | No | Modelo de la terminal. |
version | No | Versión del software de la terminal. |
has_print | No | true si la terminal tiene impresora. |
terminal_id | No | ID de la terminal, hasta 15 caracteres. |
connectivity | No | Tipo de conectividad de red. |
serial | No | Número de serie del dispositivo. |
type | No | Tipo de dispositivo POS físico. |
friendly_name | No | Nombre visible asignado a la terminal. |
user | No | Usuario operador del dispositivo. |
location | No | { "latitude": ..., "longitude": ... } — coordenadas GPS de la terminal. |
Autenticación
Usar la API
🟢 Producción
🧪 Sandbox (UAT)
https://api.kushkipagos.com/Endpoints disponibles
¿Tienes una sugerencia sobre esta documentación? Escríbenos.
Modified at 2026-09-11 14:40:59