Card Present Payments (API Raw) Usa estos endpoints para reversar o reembolsar transacciones presenciales procesadas en una terminal POS. Las dos operaciones admiten modo sin tarjeta : no se requiere leer la tarjeta al momento de la anulación o del reembolso. Endpoints# Endpoint Propósito POST /pos/v1/transactionAnula o reversa una transacción POST /pos/v1/refundReembolsa una transacción completada
Anulación / reverso# Una anulación cancela una autorización antes de la liquidación. Un reverso deshace una transacción inmediatamente después de procesarla. Pon transaction_mode en "Void" o "Reverse" y envía el transaction_reference de la transacción original. {
"transaction_type" : "charge" ,
"transaction_mode" : "Void" ,
"country" : "PER" ,
"client_transaction_id" : "a0e1b2c3-d4e5-6789-abcd-ef0123456789" ,
"transaction_reference" : "f2f29080-0214-42c0-95a5-77ecf3434cd7" ,
"amount" : {
"currency" : "PEN" ,
"subtotal_iva" : 0 ,
"subtotal_iva0" : 600 ,
"iva" : 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" ,
"pos_details" : {
"brand" : "SUNMI" ,
"model" : "P2-EU" ,
"version" : "1.1.13" ,
"has_print" : true }
} Anulación / reverso sin tarjeta# Para anular sin volver a leer la tarjeta, pon omit_card: true y omite card_details y cvm_type. {
"transaction_type" : "charge" ,
"transaction_mode" : "Void" ,
"country" : "PER" ,
"client_transaction_id" : "a0e1b2c3-d4e5-6789-abcd-ef0123456789" ,
"transaction_reference" : "f2f29080-0214-42c0-95a5-77ecf3434cd7" ,
"omit_card" : true ,
"amount" : {
"currency" : "PEN" ,
"subtotal_iva" : 0 ,
"subtotal_iva0" : 600 ,
"iva" : 0
} ,
"pos_details" : {
"brand" : "SUNMI" ,
"model" : "P2-EU" ,
"version" : "1.1.13" ,
"has_print" : true }
} Anulación parcial# Incluye el objeto amount con el monto a anular. Omítelo para una anulación total. Reembolso# Reembolsa una transacción ya liquidada usando su transaction_reference. {
"transaction_type" : "refund" ,
"transaction_mode" : "Authorization" ,
"country" : "PER" ,
"client_transaction_id" : "b1f2c3d4-e5f6-7890-bcde-f01234567890" ,
"transaction_reference" : "f2f29080-0214-42c0-95a5-77ecf3434cd7" ,
"amount" : {
"currency" : "PEN" ,
"subtotal_iva" : 0 ,
"subtotal_iva0" : 600 ,
"iva" : 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" ,
"pos_details" : {
"brand" : "SUNMI" ,
"model" : "P2-EU" ,
"version" : "1.1.13" ,
"has_print" : true }
} Reembolso sin tarjeta# Pon omit_card: true para reembolsar sin volver a leer la tarjeta. Reembolso parcial# Envía el objeto amount solo con la porción a reembolsar. Omítelo para un reembolso total. Campos del request# Anulación (POST /pos/v1/transaction)# Campo Obligatorio Descripción transaction_typeSí Tipo de la transacción original (por ejemplo, "charge", "preAuth"). transaction_modeSí "Void" para anular; "Reverse" para deshacer de inmediato.countryYes ISO 3166-1 alpha-3. Must be "PER". client_transaction_idYes UUID v4 unique per request. transaction_referenceSí Referencia de la transacción a anular. amountNo Obligatorio para anulaciones parciales . omit_cardNo true para operaciones sin tarjeta.cvm_typeNo "none", "pin" o "signature". Opcional para operaciones sin tarjeta.metadataNo Key-value object with extra data.
Reembolso (POST /pos/v1/refund)# Campo Obligatorio Descripción transaction_typeSí Siempre "refund". transaction_modeSí Siempre "Authorization". countryYes ISO 3166-1 alpha-3. Must be "PER". client_transaction_idYes UUID v4 unique per request. transaction_referenceSí Referencia de la transacción a reembolsar. amountNo Obligatorio para reembolsos parciales . omit_cardNo true para reembolsos sin tarjeta.cvm_typeNo Método de verificación del tarjetahabiente. Opcional para operaciones sin tarjeta. metadataNo Key-value object with extra data.
amount# Campo Obligatorio Descripción currencySí "PEN" o "USD".subtotal_ivaSí Subtotal afecto a IGV. Ponlo en 0 si no aplica IGV. subtotal_iva0Sí Subtotal no afecto a IGV. ivaSí Monto del IGV. Ponlo en 0 si no aplica IGV. tipNo Monto de la propina incluido en el cargo original.
Autenticación# Usar la API# https://api.kushkipagos.com/Endpoints disponibles#
Anulación / Reverso
Anula una autorización (void) o deshace una transacción de inmediato (reverse). Admite operaciones sin tarjeta y anulaciones parciales.
Reembolso
Reembolsa una transacción presencial ya liquidada — total o parcial, con o sin lectura de la tarjeta. ¿Tienes una sugerencia sobre esta documentación? Escríbenos . Modified at 2026-09-11 14:41:08
