Cargo directo (sin token)

Esta funcionalidad se encuentra disponible para los siguientes modelos:

☑ Adquirente

☐ Agregador

Para conocer los tipos de tarjeta habilitados en cada uno de los modelos de afiliación, por favor consulta nuestra guía de marcas de tarjeta soportados.

Recibir pagos directos con tarjetas de débito y crédito en tu sitio consiste en capturar la información de la tarjeta y enviar el pago a Kushki para ser procesado. Esta forma de integración es más simple, ya que no es necesario solicitar un token y luego un charge para procesar un cargo directo o una preautorización, sino que basta con consumir un solo servicio de cargo directo.

Importante

Esta forma de procesamiento requiere ser PCI compliance.

Limitaciones

Solo está disponible con adquirencia Kushki en Chile 🇨🇱, Colombia 🇨🇴, México 🇲🇽 y Perú 🇵🇪.

Solo disponible para cargos únicos y preautorizaciones con tarjetas Visa y Mastercard.

Soporta ✅	No soporta ❌
- Pagos únicos con tarjeta de débito y crédito - Cargos recurrentes de Kushki -Pagos diferidos (Meses sin intereses) - Autorización y captura	- Integración con librerías de Front (Kushki.js, Android, iOS -Autenticación OTP y 3DS de Kushki(en su lugar podrás usar tu propio motor de autenticación antifraude) -Motor antifraude Siftscience

El flujo de pago que integrarás es el siguiente:

Cargo simple

Para realizar un cargo simple con tarjeta, deberás usar los datos de la tarjeta y de tu cliente para realizar una llamada a nuestro endpoint de pagos sin token para iniciar el cobro.

JavaScript

Python

PHP

Cargos diferidos

Si se quiere hacer pago con opción de diferidos, asegúrate de enviar el objeto deferred con los parámetros meses de gracia, meses y tipo de crédito (recibidos al consultar los diferidos para un BIN). Como respuesta a esta llamada, recibirás el nombre del diferido , el tipo type (corresponde al creditType al ejecutar el cargo), los meses disponibles y los meses de gracia (skip payments), tal como se muestra en el siguiente ejemplo de respuesta. Esta es la información que deberás usar al ejecutar el cargo:

[
   {
      "months":[
         "3",
         "6",
         "9",
         "12"
      ],
      "monthsOfGrace":[],
      "name":"Sin intereses al tarjetahabiente",
      "type":"03"
   }
]

Y así deberás enviar el objeto deferred en un cargo:

{
  "card": {
    "name": "John Doe",
    "number": "5311220000122112",
    "expiryMonth": "12",
    "expiryYear": "30",
    "cvv": "123"
  },
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 500,
    "ice": 0,
    "iva": 0,
    "currency": "USD",
    "isDeferred": true,
    "deferred": {
      "graceMonths": "00",
      "creditType": "03",
      "months": 3
    }
  },
  "metadata": {
    "Referencia": "99999"
  },
  "contactDetails": {
    "documentType": "CC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "orderDetails": {
    "siteDomain": "example.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    }
  },
  "productDetails": {
    "product": [
      {
        "id": "198952AB",
        "title": "eBook Digital Services",
        "price": 10000,
        "sku": "10101042",
        "quantity": 1
      }
    ]
  },
  "fullResponse": "v2"
}

Importante

El objeto deferred solo debe enviarse en los casos en que la tarjeta tenga la posibilidad de hacer pagos diferidos, en todos los demás casos el objeto mencionado debe omitirse.

Importante

Los tipos de diferido disponibles para tu cliente dependerán del BIN de la tarjeta.

Revisa nuestra Referencia de la API para mayor información.

Autenticación 3DS externa

En caso de que cuentes con tu propio motor de autenticación 3DS, incluye el objeto threeDomainSecure en tu solicitud.

Dependiendo de la marca, los campos a enviar varían:

Visa	Mastercard
`cavv`	`directoryServerTransactionID`
`eci`	`eci`
`xid`	`ucaf`
`specificationVersion`	`specificationVersion`
`Cell`	`collectionIndicator`

El campo eci (Electronic Commerce Indicator) permite los siguientes valores:

Visa:

eci: 05 y 06 representa transacciones seguras.

eci: 07 representa transacciones riesgosas. Para procesar transacciones riesgosas, envía el campo acceptRisk en true.

Mastercard:

eci: 01 and 02 representa transacciones seguras.

eci: 00 representa transacciones riesgosas. Para procesar transacciones riesgosas, envía el campo acceptRisk en true.

Importante

Al enviar en true el campo `acceptRisk, el comercio o PSP asumirá la responsabilidad en caso de un contracargo

A continuación un ejemplo de un cargo incluyendo el objeto threeDomainSecure:


{
  "card": {
    "name": "John Doe",
    "number": "5311220000122112",
    "expiryMonth": "12",
    "expiryYear": "30",
    "cvv": "123"
  },
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 5000,
    "ice": 0,
    "iva": 0,
    "currency": "MXN",
    "isDeferred": false
  },
  "fullResponse": "v2",
  "metadata": {
    "Referencia": "99999"
  },
  "contactDetails": {
    "documentType": "CC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "orderDetails": {
    "siteDomain": "example.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    }
  },
  "productDetails": {
    "product": [
      {
        "id": "198952AB",
        "title": "eBook Digital Services",
        "price": 10000,
        "sku": "10101042",
        "quantity": 1
      }
    ]
  },
  "threeDomainSecure": {
    "cavv": "AAABBoVBaZKAR3BkdkFpELpWIiE=",
    "eci": "07",
    "xid": "NEpab1F1MEdtaWJ2bEY3ckYxQzE=",
    "specificationVersion": "2.2.0",
    "acceptRisk": false
  }
}

Procesa suscripciones externas a Kushki

Con Kushki, puedes cursar cobros si tienes tu propio motor de suscripciones. Para ello hay 2 opciones:

Opción 1. Sin envío de CVV

Solicita a Kushki la activación del servicio en tu cuenta.

Envía el cargo cin CVV. Asegúrate de enviar el campo externalSubscriptionID con el id de la suscripción de tu motor externo con una longitud igual o menor a 20 caracteres alfanuméricos, de esta forma Kushki identificará que corresponde a una subscripción administrada por un motor externo.

{
  "card": {
    "name": "John Doe",
    "number": "5311220000122112",
    "expiryMonth": "12",
    "expiryYear": "30",
    "cvv": "123"
  },
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 5000,
    "ice": 0,
    "iva": 0,
    "currency": "MXN",
    "isDeferred": false
  },
  "metadata": {
    "Referencia": "99999"
  },
  "contactDetails": {
    "documentType": "CC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "orderDetails": {
    "siteDomain": "example.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    }
  },
  "productDetails": {
    "product": [
      {
        "id": "198952AB",
        "title": "eBook Digital Services",
        "price": 10000,
        "sku": "10101042",
        "quantity": 1
      }
    ]
  },
  "externalSubscriptionID": "662829373638",
  "fullResponse": "v2"
}

Opción 2. Envíando el cvv en la transacción inicial

Envía initialRecurrence en el parámetro transactionMode y procesa el cargo. Para esta transacción inicial desde enviar el cvv.

{
  "card": {
    "name": "John Doe",
    "number": "5311220000122112",
    "expiryMonth": "12",
    "expiryYear": "30",
    "cvv": "123"
  },
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 5000,
    "ice": 0,
    "iva": 0,
    "currency": "MXN",
    "isDeferred": false
  },
  "metadata": {
    "Referencia": "99999"
  },
  "contactDetails": {
    "documentType": "CC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "orderDetails": {
    "siteDomain": "example.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    }
  },
  "productDetails": {
    "product": [
      {
        "id": "198952AB",
        "title": "eBook Digital Services",
        "price": 10000,
        "sku": "10101042",
        "quantity": 1
      }
    ]
  },
  "citMit": "C101",
  "transactionMode": "initialRecurrence",
  "fullResponse": "v2"
}

Asegúrate de guardar el transactionReference del cargo completado en el paso anterior.

Para las transacciones posteriores sin cvv, envía subsequentRecurrence en el parámetro transactionMode y asegúrate de incluir el transactionReference el el campo initialRecurrenceReference.

{
  "card": {
    "name": "John Doe",
    "number": "5311220000122112",
    "expiryMonth": "12",
    "expiryYear": "30"
  },
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 5000,
    "ice": 0,
    "iva": 0,
    "currency": "MXN",
    "isDeferred": false
  },
  "metadata": {
    "Referencia": "99999"
  },
  "contactDetails": {
    "documentType": "CC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "orderDetails": {
    "siteDomain": "example.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+593912345686",
      "address1": "Eloy Alfaro 139 y Catalina Aldaz",
      "address2": "centro 123",
      "city": "Quito",
      "region": "Pichincha",
      "country": "Ecuador"
    }
  },
  "productDetails": {
    "product": [
      {
        "id": "198952AB",
        "title": "eBook Digital Services",
        "price": 10000,
        "sku": "10101042",
        "quantity": 1
      }
    ]
  },
  "transactionMode": "subsequentRecurrence",
  "initialRecurrenceReference": "c76e2057-fe15-4f90-990c-5d35d130f018",
  "fullResponse": "v2"
}

Prueba tu integración

Existen tarjetas de prueba que puedes utilizar en el ambiente UAT para asegurarte de que tu integración está lista. Úsalas con cualquier CVV, código postal y fecha de expiración futura.

Transacción aprobada: 5451951574925480

Transacción declinada en solicitud de token (front-end): 4574441215190335

Transacción declinada en solicitud de cobro (back-end): 4349003000047015

Cargo directo (sin token)

Limitaciones#

Cargo simple#

Cargos diferidos#

Autenticación 3DS externa#

Procesa suscripciones externas a Kushki#

Opción 1. Sin envío de CVV#

Opción 2. Envíando el cvv en la transacción inicial#

Prueba tu integración#

Limitaciones

Cargo simple

Cargos diferidos

Autenticación 3DS externa

Procesa suscripciones externas a Kushki

Opción 1. Sin envío de CVV

Opción 2. Envíando el cvv en la transacción inicial

Prueba tu integración