Cobro simple

Esta funcionalidad se encuentra disponible para los siguientes modelos:

☑ Adquirente
☐ Agregador

Revisa la información a continuación para conocer el funcionamiento de cada servicio.

Venta simple (en un paso)

Para realizar cargos simples, es necesario que consumas el endpoint https://api-uat.kushkipagos.com /pos/v1/transaction y que envíes charge en el campo transaction_type y Authorization en el campo transaction_mode como parte del cuerpo del requerimiento. Por favor sigue los pasos de la guía disponible en la API.

El request que debes enviar depende del canal de lectura de la terminal POS de tu comercio:

  • ICC: Lectura de chip
  • MCR: Lectura de banda mágnetica
  • NFC: Lectura sin contacto

Revisa los ejemplos a continuación:

Ejemplos de venta simple

  • JSON
  • JSON
  • JSON
//ICC
{
"card": {
"card_holder_name": "CUST IMP MC 103"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "CLP",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 60000
},
"country": "CHL",
"cvm_type": "none",
"is_cashback": false,
"is_deferred": false,
"merchant_id": "0987654321",
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.26",
"location": {
"latitude": -0.22480833333333333,
"longitude": -78.487955
},
"has_print": true,
"terminal_id": "PB04216R20537"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"
},
"enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29",
"pin_ksn": "FFFF4357486333600002",
"reading_type": "ICC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "-1",
"document_number": "",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a"
}
//MCR
{
"card": {
"card_holder_name": "C92546CB8524197A17A1B960D5D09A01ABBE63E5478FD5155DBE2B18824771046EEA135D73B192236937AF33E781B81804098835D3A1AD81A863BAEA3BAA42E4"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "CLP",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 2000
},
"country": "CHL",
"cvm_type": "Chip",
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.13",
"location": {
"latitude": -0.1848534,
"longitude": -78.4769761
},
"has_print": true,
"terminal_id": "PB04209860189"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track1": "06056D9EE9D77E4D846912F77C0B37C5FC6A95D1DF21DD502D3A08E8141CF82818F5DC4FA7637F400EA488D388F2B70F8A22EAEFBBEEDDE93A118BFB789BD8C0",
"enc_track2": "FD580B3BBFCCB821EAB4AB64947C4632C0BE6C70AB4ECDE4"
},
"pin_ksn": "FFFF4357486333600002",
"reading_type": "MCR"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "0",
"document_number": "123666",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "ae6dd91a-9173-4ec7-8934-3178454ef341"
}
///NFC
{
"card": {
"card_holder_name": "Jhon Doe/"
},
"amount": {
"iva": 0,
"currency": "CLP",
"extra_taxes": {
"tip": 12000
},
"subtotal_iva": 0,
"subtotal_iva0": 2000
},
"country": "CLP",
"isDeferred": false,
"is_cashback": false,
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.18",
"location": {
"latitude": -1.2253600000000002,
"longitude": -78.61997
},
"has_print": true,
"terminal_id": "PB04209860189"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"
},
"enc_tlv": "CE447A062C49774934E42A7F826668C0A53CE9AF633A510E66C8031171AAFCF8CE29857B19101326ED67512533B86C51ED16C5E624DA97EDA72864A39763822418FCAC5439D2F1F72F6FC0BAA6EED37630767D9D161612654E49944FC435525C6C356177B1BD0A545C19FF5E47685E35B02B20B307BDE2A26FAD2F42D7CB00BE9C53FD05BECE71110919ADE3158398B8B02003F682374B942C4B6D7FD54DE2B65A9C66125DF28A80",
"pin_ksn": "FFFF4357486333600002",
"reading_type": "NFC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "0",
"document_number": "1111111",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "cffd9e13-993d-4d8b-9862-3ac4c0f63dec"
}

Venta simple con cashback (Producto en fase Alfa)

Kushki te permite realizar ventas con retiro de efectivo o cashback. Para realizar una transacción de este tipo, envía la petición de cobro en el endpoint https://api-uat.kushkipagos.com /pos/v1/transaction (el mismo de la venta simple) y asegúrate de enviar el campo is_cashback con valor de true y el monto a devolver en el parámetro cashback_amount.

Revisa el ejemplo a continuación:

{
"card": {
"card_holder_name": "John Doe"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "CLP",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 200000
},
"country": "CHL",
"is_cashback": true,
"cashback_amount": 10000,
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.13",
"location": {
"latitude": -0.1848534,
"longitude": -78.4769761
},
"has_print": true,
"terminal_id": "PB04209860189"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track1": "06056D9EE9D77E4D846912F77C0B37C5FC6A95D1DF21DD502D3A08E8141CF82818F5DC4FA7637F400EA488D388F2B70F8A22EAEFBBEEDDE93A118BFB789BD8C0",
"enc_track2": "FD580B3BBFCCB821EAB4AB64947C4632C0BE6C70AB4ECDE4"
},
"pin_ksn": "FFFF4357486333600002",
"reading_type": "MCR"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "0",
"document_number": "123666",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "ae6dd91a-9173-4ec7-8934-3178454ef341"
}

Venta con propina

En tu comercio, a través del servicio de tarjeta presente, puedes aceptar pagos con propina en tu comercio, agregando un campo adicional con la información de dicha propina.

Para aceptar este tipo de servicio, es necesario que consumas el endpoint https://api-uat.kushkipagos.com /pos/v1/transaction y que incluyas el valor de la propina en el campo tip y envíes Authorization en el campo transaction_mode y charge en el campo transaction_type como parte del cuerpo del requerimiento. Por favor sigue los pasos de la guía disponible en la API de Kushki.

Revisa el ejemplo a continuación:

{
"card": {
"card_holder_name": "CUST IMP MC 103"
},
"amount": {
"iva": 0,
"tip": 10000,
"currency": "CLP",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 60000
},
"country": "CHL",
"cvm_type": "none",
"is_cashback": false,
"is_deferred": false,
"merchant_id": "0987654321",
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.26",
"location": {
"latitude": -0.22480833333333333,
"longitude": -78.487955
},
"has_print": true,
"terminal_id": "PB04216R20537"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"
},
"enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29",
"pin_ksn": "FFFF4357486333600002",
"reading_type": "ICC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "-1",
"document_number": "",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a"
}

Para más información de cómo enviar la propina en una transacción, consulta nuestra sección de preguntas frecuentes.

Venta en cuotas (diferida)

Si tu cliente solicita diferir el cobro del pago de la transacción realizada en tu comercio, es necesario que consumas el endpoint https://api-uat.kushkipagos.com /pos/v1/transaction y que envíes charge en el campo transaction_type y Authorization en el campo transaction_mode como parte del cuerpo del requerimiento. En el campo deferred y luego months, es requerido incluir el número total de meses en los que se diferirá el pago de tu cliente.

"deferred": {
"months": "12"
},

Por favor sigue los pasos de la guía disponible en la API para más información.

Ejemplo de pago diferido

Revisa a continuación un ejemplo del requerimiento que debes enviar:

{
"card": {
"card_holder_name": " /"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "CLP",
"extra_taxes": {},
"subtotal_iva": 0,
"subtotal_iva0": 10000
},
"country": "CHL",
"cvm_type": "none",
"deferred": {
"months": "10"
},
"is_cashback": false,
"is_deferred": true,
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.28",
"location": {
"latitude": -1.2346533333333334,
"longitude": -78.61959166666666
},
"has_print": true,
"terminal_id": "PB04209860189"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600003",
"enc_track2": "A5A26987202B4E8F3A595E0116A85E56D842005394315A18"
},
"enc_tlv": "8332743DB0D0FAA29CF0AA187558BE3EF056085299635BAD4147E5D50D70D6E01A396081D618BA3001AF8262CD8F52DC67C995D9E99E824EC7995FE20AD5E5FE850B29863A2E61D8BD6A2951A2F24CD0AEE4087020745EB48CC5B40E2AE2263D5BB47D4D508D8DC69E54C8ECC2AB6F471C299D1CAB1712CCD2E2D378A57D285E7139CCC6C98D57D8A6C30B1CE110DDE23C28C9C7FCAFEF2023AE4FC8B03BE86CA1B673D962D9E7EA",
"pin_ksn": "FFFF4357486333600003",
"reading_type": "NFC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "-1",
"document_number": "",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "charge",
"client_transaction_id": "dbdeb25b-b34a-4b6c-b664-085ea9552954"
}

Reserva de fondos con tarjeta presente

Separa un cupo ahora y realiza la captura del pago cuando se complete el servicio o la entrega del producto