Procesamiento de Checkout con Wallet
Este tipo de procesamiento permite generar una operacion via API permitiendo personalizar la experiencia de pago.. Siempre se deben tener en cuenta las medidas de seguridad adecuadas para este tipo de Operatoria donde se manipulara el PAN del Cliente.
sequenceDiagram
participant Sistema
participant Gire
Sistema->> Gire: Crear Operacion
Note right of Gire: Utilizar Private Key
Gire->>Sistema: Guardar Intent Token
Sistema->> Gire: Generar Token Tarjeta
Note right of Gire: Utilizar Public Key
Gire ->>Sistema: Devuelve Token
Sistema->>Gire: Generar CobroGenerales
Nuestro checkout transparente le permitirá generar operaciones desde su sitio siempre y cuando las mismas sean de Tipo Tarjeta de Crédito o Débito. Además como parte de la creación del checkout también se le brindará un Checkout standard para el procesamiento de medios de pago NO tarjeta. En este tipo de Checkout hay algunos datos como Customer que son Obligatorios y deben enviarse siempre, de lo contrario la operación no podrá realizarse.
Requerimientos
- Llave publica
- Llave privada
Sitios Web
- Calificación **A** o mayor en https://www.ssllabs.com/ssltest . Si el sitio web arroja menor a A las credenciales serán desactivadas automáticamente. Todos los sitios que utilicen esta operatoria serán monitoreados a diario.
Creación de Checkout
1) Crear Intencion de Cobro
POST: https://api.bdp.gire.com/p/checkout Cabeceras:
- api-key: Llave Privada
Parámetros:
Admite todos los parámetros de Checkout, pero además se establecen los siguientes:
- customer: Objeto de tipo JSON con los datos del cliente. Obligatorios:
- uid: Identificador único e interno del cliente.
- name: Nombre del Cliente.
- identification: DNI.
- phone: Número de Celular.
- email: Email del Cliente
- wallet: Habilita la opción de billetera virtual para el almacenado de Tarjetas (Opcional). En este caso debe estar en true.
- options: Objeto con opciones.
- domain: Dominio desde el que se procesará el Checkout (Obligatorio).
Ejemplo:
curl --location --request POST 'https://api.bdp.gire.com/p/checkout' \
--header 'api-key: _8bjoCPu4xW5GCHsp5yDHzSmhMnQU1k9999' \
--header 'x-lang: es' \
--header 'Content-Type: application/json' \
--data-raw '{
"total": 5,
"currency": "ARS",
"reference": "2982-2XtPXlgSaWccqUyobuv4sEmLYMV0N6oX6Moriwww",
"description": "Descripción de la Venta",
"customer": {
"uid": "12123123",
"name": "Demo Gire",
"identification": "23234234",
"email": "[email protected]"
},
"options": {
"domain": "mi.dominio.com"
}
"wallet": true,
"return_url": "https://test/sale/return?session=56789",
"webhook": "https://test/sale/webhook?user=1234"
}'Respuesta: Para procesar en modo transparente se debe obtener data.wallet.it ya que será el parámetro necesario para el resto de las APIs.
{
"result": true,
"data": {
"id": "PYCNWIF9MSXV1QYLNG",
"url": "https://test/p/checkout/v2/PYCNWIF9MSXV1QYLNG",
"description": "Descripción de la Venta",
"currency": "ARS",
"total": 5,
"created": 1598424066850,
"customer": {
"name": "Demo Gire"
},
"wallet": [
{
"it": "5ca170c7-b74a-469a-8e61-3635148cbc5d",
"name": "Visa terminada en 8545",
"source": {
"reference": "visa.comafi",
"name": "Visa Banco Comafi",
"shortName": "Visa Comafi",
"card": {
"currency": "ARS",
"product": {
"name": "Visa",
"shortName": "Visa",
"variant": "credit",
"lengths": [
16
],
"gaps": [
4,
8,
12
],
"code": {
"name": "CVV",
"length": 3,
"position": 1
},
"logo": "https://res.gire.com/images/sources/png/visa.png"
},
"issuer": {
"shortName": "Comafi",
"name": "Banco Comafi",
"color": "#789c48",
"logo": "https://res.gire.com/images/sources/png/comafi.png"
},
"level": "classic"
},
"type": "card",
"priority": 0
},
"card": {
"expiration_month": 2,
"expiration_year": 24,
"card_number": "402123******8888"
},
"installments": [
{
"name": "1 Pago",
"description": "1 Pago",
"count": 1,
"reference": "1",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 5.1,
"count": 1
},
"total": 5.1,
"financial": {
"percentage": 2,
"amount": 0.1
}
}
},
{
"name": "3 Cuotas",
"description": "3 Cuotas",
"count": 3,
"reference": "3",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 1.94,
"count": 3
},
"total": 5.83,
"financial": {
"percentage": 16.5,
"amount": 0.83
}
}
},
{
"name": "6 Cuotas",
"description": "6 Cuotas",
"count": 6,
"reference": "6",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 1.09,
"count": 6
},
"total": 6.55,
"financial": {
"percentage": 31,
"amount": 1.55
}
}
},
{
"name": "10 cuotas",
"description": "10 Cuotas",
"count": 10,
"reference": "10",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 0.51,
"count": 10
},
"total": 5.1,
"financial": {
"percentage": 2,
"amount": 0.1
}
}
},
{
"name": "Ahora 12",
"description": "",
"count": 12,
"reference": "ahora_12",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 0.43,
"count": 12
},
"total": 5.1,
"financial": {
"percentage": 2,
"amount": 0.1
}
}
},
{
"name": "Ahora 18",
"description": "",
"count": 18,
"reference": "ahora_18",
"totals": {
"currency": {
"value": "ARS",
"label": "Peso Argentino",
"symbol": "$",
"hidden": false
},
"installment": {
"amount": 0.28,
"count": 18
},
"total": 5.1,
"financial": {
"percentage": 2,
"amount": 0.1
}
}
}
]
}
]
}
}
Procesamiento con Wallet via API
1) Generar un nuevo Checkout desde el lado Servidor utilizando Llave Privada. 2) Obtener desde el Objeto wallet.it ( intent_token ) y wallet.installments.reference 3) Procesar la Operación se debe enviar securityCode como parametro adicional en Body.
Procesamiento:
POST: https://api.bdp.gire.com/p/operations/{{intent_token}} Cabeceras:
- api-key: Llave Pública
Parámetros (Body): - `installment`: Reference Obtenido desde las cuotas calculadas para la tarjeta elegida en wallet. - `securityCode`: Código de Seguridad de la tarjeta elegida. Respuesta: