Tarjeta Presente

API para procesamiento con SDK

5min

we

Consta básicamente de los siguientes pasos:

  • Generación de la intención de Pago (Intent Token)
  • Detección de tarjeta ingresada (Opcional)
  • Creación de Token de tarjeta (Se gestiona a través del SDK)
  • Procesamiento de la operación (Se gestiona a través del SDK)



Generación de Intent Token

El primer paso para realizar una operación en modalidad tarjeta presente es obtener el Intent Token, en el cuál se definen todas las características de la operación.

La API a utilizar es:

POST
Request
Header Parameters
api-key
optional
String
Llave Privada de la entidad
Body Parameters
total
required
Number
Total de la operación
serialNumber
required
String
Serial Reference generado por el SDK identificatorio del lector
test
optional
Boolean
Indica si la operación realizada está en modo TEST
currency
optional
String
Moneda de la operación. Formato ISO 4217
otherAmount
optional
Number
Importe adicional de la operación. Aplica unicamente para operatorias de cashback, la entidad debe estar habilitada para tal fin.
submerchant
optional
Object
Objeto que contiene toda la información relacionada al subcomercio, requerido en Agrupadores o Pay Fac
intent
optional
String
Flujo de la operación, permite soportar operaciones en 2 pasos. Valores posibles: "payment.2-step", "payment.v2". Por defecto la captura de la operación es automática
reference
optional
String
Reference externa de la operación asignada por el consumidor del servicio.
description
optional
String
Descripción de la operación
webhook
optional
String
URL donde se realizará la notificación sobre las actualizaciones sobre el cobro realizado.


Parámetro a Almacenar

Se debe guardar el valor de "data.intent.token" para ser utilizado en las siguientes operaciones.



Detección de tarjeta ingresada

Una vez obtenido el intent.token de la operación, es posible realizar la detección de la tarjeta ingresada por el cliente para visualizar los planes de cuotas definidos para la misma. Esta detección se realiza sobre el BIN de la tarjeta, es decir, sobre los primeros 6 dígitos del PAN.

Esta API se encuentra restringida a los comercios que hayan solicitado el módulo de cálculo de promociones.

La API a utilizar es:

POST
Request
Query Parameters
intent_token
optional
String
Intent Token correspondiente al checkout creado anteriormente
Header Parameters
api-key
optional
String
Llave pública de la entidad
Body Parameters
type
required
String
Tipo de medio de pago a consultar. Valor fijo: "card"
data
optional
Object
Objeto de tipo JSON con los datos de la tarjeta a detectar.
data.bin
optional
String
BIN de la tarjeta a detectar (primeros 6 dígitos)
options
optional
Object
Objeto de tipo JSON con las opciones de detección
options.installments
optional
Boolean
Valor true/false que habilita el cálculo de cuotas.




Procesamiento con el plan de cuotas

Se debe almacenar el valor "data.installments.reference" correspondiente al plan de cuotas elegido para ser utilizado luego al procesar la operación

Devolución de Operaciones

Para realizar la devolución de operaciones, tambien es requisito la generación de un Intent Token de devolución

POST
Request
Path Params
uid
required
String
ID del cupón a devolver
Header Parameters
api-key
required
String
Llave privada de la entidad
x-suga-entity
required
String
UID de la entidad a la que pertenece la operación. En relación al intent token de procesamiento, debe ser igual al parámetro "submerchant.reference"
Body Parameters
total
optional
Number
Importe a devolver en el caso de que se realice una devolución parcial. En caso de anulaciones o devoluciones totales, este campo no es requerido




Updated 04 Aug 2023
Did this page help you?