POST Ejecutar cobro con Tarjeta

Método de cobro en un solo paso

Descripción

Para ejecutar el cobro de una operación se debe emplear el método POST purchase

En el body viajan

• Identificación de la Entidad dentro de pagoUno (external_reference)

• Datos sensibles de la tarjeta (PAN-vencimiento-CVV)

• Datos del tarjeta-habiente (nombre, documento, fecha de nacimiento, mail, telefono, bandera de notificación)

  • la bandera de notificación en true permitirá mandar notificaciones al mail o teléfono del tarjeta-habiente

• Lista de Compra (merchant group con su access key, monto, plan, cuotas, moneda, datos del vendedor para el resumen de tarjeta)

• Datos para control de fraude (control por Score o pago garantizado)

  • Cuando el control es a través scoring, debe ser informado el máximo valor para la aceptación del riesgo.

En el response se recibirá

• El resultado de la transacción (approved "true" o "false" dependiendo de si el pago fue autorizado o no)

• Los datos de tokenización de la tarjeta (primary_account_token y primary_account_token_auth)

• El resultado del control de fraude

• El id de la transacción

• Entre otros

Utilidad de tokenización

La tokenización le permitirá recordar los datos de PAN y fecha de vencimiento

Esto le permitirá proponer el uso de una tarjeta registrada en operaciones subsecuentes evitando así el reingreso del PAN y la fecha de vencimiento, sólo será necesario el ingreso del código de seguridad (el CVV jamás es almacenado en nuestras bases)

También le permitirá realizar operaciones CON TOKEN, siempre que el comercio este habilitado para realizar cobros sin código de seguridad. Esta funcionalidad es útil en pagos recurrentes, en donde deberá gestionar con EntradaUno el código de subscripción adecuado.

Utilidad de Control de Fraude

Si el comercio desea realizar control de prevención de fraude deberá primeramente contar con este servicio habilitado en EntradaUno

Caso contrario los parámetros deben viajar como se indica en el ejemplo

Utilidad de Notificación

Si el comercio desea enviar una notificación al cliente (por correo electrónico o teléfono) sobre el pago efectuado, deberá primeramente contar con este servicio habilitado en EntradaUno

Caso contrario el parámetro debe viajar como se indica en el ejemplo.

Request para cobros con tarjeta en un solo paso

POST /payment/purchase/

IMPORTANTE:

*️Todos los parámetros marcados con * (asterisco) son OBLIGATORIOS

👉La URL del host para su implementación debe ser solicitada al área de soporte

💵El parámetro transaction_amount no debe contener ni puntos ni comas, los últimos dos dígitos siempre serán utilizados para la parte decimal del monto, si quiero realizar un operación por 100.50 (100 con 50 centavos) se debe enviar 10050

🛃 Los Token recibidos sólo son válidos para los comercios del Merchant que realizó la operación.

La llamada se realizará enviando en el body el json de parámetros como se muestra en el siguiente ejemplo:

A) con tarjeta

{ "is_scoring_required": false, "max_risk_score": 0, "is_payment_guaranteeable": false, "customer_transaction_identificator": "xxxxx_v3", "card_holder": { "front_name": "Juan Lopez", "birth_date": "01011990", "email": "[e-mail]", "telephone": 1132840000, "document_type": "DNI", "document_number": "99999", "notification": false }, "purchase_list": [ { "merchant_code_group": "grupo", "access_key_merchant_code_group": "xxxxxxx-xxxx-x-xxxxx", "transaction_amount": 1000, "installments_plan": 0, "installments": 1, "transaction_currency_code": "032", "seller_descriptor": "TEST_V3" } ], "oWEB": { "primary_account_number": "45454544444444", "expiration_date": "2502", "card_security_code": "123" } }

Headers

Name	Type	Description
Content-Type*	String	application/json

Request Body

Name	Type	Description
customer_transaction_identificator*	str	Identificación de la Entidad dentro de pagoUno (external_reference).
oWEB*	Object	Datos de la Tarjeta: PAN, Vencimiento y CVV
primary_account_number*	str	PAN. Numero de Tarjeta. Longitud Mínima: 15 dígitos
expiration_date*	str	Fecha de Vencimiento de la tarjeta expresada como aamm
card_security_code	str	Código de seguridad de la tarjeta.
card_holder*	Object	Datos del Tarjeta-Habiente: nombre, fecha de nacimiento, documento, teléfono, correo, bandera de notificación
front_name*	str	Nombre del Tarjeta-Habiente tal cual se muestra en la tarjeta
birth_date*	str	Fecha de Nacimiento del Tarjeta-Habiente
document_type*	str	Tipo de documento. Ej: dni, DNI, cuil, CUIL.
document_number*	str	Número de Documento del Tarjeta-Habiente
telephone	number	Teléfono
email	str	Correo Electrónico
notification	boolean	Valores permitidos: true, false
purchase_list*	array	Lista de Compras Es obligatorio tener al menos un elemento en esta lista. Compuesta por: merchant group con su access key, monto, plan, cuotas, moneda, datos del vendedor para el resumen de tarjeta
merchant_code_group*	str	Grupo de Códigos de Comercio
access_key_merchant_code_group*	str	Clave de acceso del merchant_code_group
transaction_amount*	number	Monto de la transacción. Importe mínimo: 1000 ($10) IMPORTANTE: El monto debe escribirse sin puntos ni coma. Los últimos dos dígitos siempre representan la parte decimal. Ejemplo: Si quiere realizar una transacción por $12.34 (doce pesos con treinta y cuatro centavos) debe enviar 1234
installments_plan*	number	Valor permitido: 0
installments*	number	Cantidad de Cuotas. Valor Mínimo: 1 Valor Máximo: 99 IMPORTANTE: ver los valores especiales usados en el "Programa Ahora"
transaction_currency_code*	str	Valor Permitido: 032 El Valor 032 corresponde a la moneda local de la República Argentina (ARS)
seller_descriptor*	str	Datos del Vendedor. Esta descripción aparecerá en el resumen de cuenta del tarjeta-habiente. Longitud máxima 25 caracteres. Caracteres aceptados: [A-Z];[0-9];[*] El campo es de texto libre pero debe construirse bajo las siguientes condiciones: Código asignado por EntradaUno * Nombre de Fantasía del Vendedor
is_scoring_required	boolean	Valores permitidos: true, false
max_risk_score	number	Valor Mínimo: 0 Valor Máximo: 99
is_payment_guaranteeable	boolean	Valores permitidos: true, false

200: OK Una respuesta 200 indica que el request fue ejecutado correctamente. Para conocer el resultado de la transacción se debe observar el valor retornado en el parámetro approved. A continuación un ejemplo de response de una transacción APROBADA

{
    "status": 200,
    "message": "",
    "data": [
        {
            "request_id": "1022665110-f6167c62-ccb4-4dd9-a16a-17d45a5c9c00",
            "success": true,
            "pending": false,
            "message": null,
            "cycle": 3,
            "response": {
                "id": "85A9A047-A42B-43E3-9B6A-DEEFF28F0000",
                "approved": true,
                "seller_descriptor": "",
                "message": "APROBADA",
                "merchant_code": "00000001",
                "merchant_code_terminal": "00000001",
                "authorization": "002539",
                "ticket_number": "4193",
                "batch_number": "243",
                "transaction_amount": 1000,
                "capture_date": "0112",
                "account_number": "000000000060",
                "bin": "493715",
                "last_4_digits": "0000",
                "primary_account_token": "12000000-A082-4044-A082-00FFDEBB0000",
                "primary_account_token_auth": "6D0B61AB621960E77419E888XXXXXXXX",
                "validation_raw": "VTE0010",
                "validation": null
            },
            "fraud_detection": {
                "card_first_six": null,
                "card_last_four": null,
                "card_type_cd": null,
                "fraud_indicator": null,
                "is_payment_guaranteeable": null,
                "is_shadow_payment": null,
                "payment_guarantee_status": null,
                "paymentID": null,
                "payment_status": null,
                "permanent_token": null,
                "response_code": null,
                "response_text": null,
                "risk_decision_code": null,
                "risk_decision_dode_text": null,
                "risk_probability_index": null,
                "risk_score": null,
                "risk_system_decision": [
                    {
                        "description": null,
                        "risk_system_decision_cd": null
                    }
                ]
            }
        }
    ]
}

403: Forbidden

{
    "status": 403,
    "message": "Ivalid primary_account_token_auth",
    "data": null
}

200: OK Respuesta para una transacción NO APROBADA

{
    "status": 200,
    "message": "",
    "data": [
        {
            "request_id": "1701265845-3b38d7f6-c0f3-4f63-9850-64e15e11fd7a",
            "success": true,
            "pending": false,
            "message": null,
            "cycle": 2,
            "response": {
                "id": "35E4026B-6244-4E2D-9002-13F7F6CC3713",
                "approved": false,
                "seller_descriptor": "",
                "message": "PEDIR AUTORIZACION",
                "message_host": "",
                "merchant_code": "52103207",
                "merchant_code_terminal": "97115807",
                "authorization": "",
                "ticket_number": "5622",
                "batch_number": "258",
                "transaction_amount": 1000,
                "capture_date": "0120",
                "account_number": "311706048668",
                "bin": "454545",
                "last_4_digits": "4444",
                "primary_account_token": "",
                "primary_account_token_auth": "",
                "validation_raw": "",
                "validation": null
            },
            "fraud_detection": {
                "card_first_six": null,
                "card_last_four": null,
                "card_type_cd": null,
                "fraud_indicator": null,
                "is_payment_guaranteeable": null,
                "is_shadow_payment": null,
                "payment_guarantee_status": null,
                "paymentID": null,
                "payment_status": null,
                "permanent_token": null,
                "response_code": null,
                "response_text": null,
                "risk_decision_code": null,
                "risk_decision_dode_text": null,
                "risk_probability_index": null,
                "risk_score": null,
                "risk_system_decision": [
                    {
                        "description": null,
                        "risk_system_decision_cd": null
                    }
                ]
            }
        }
    ]
}

Ejemplo Request para cobro con tarjeta

    "customer_transaction_identificator": "xxxxx_v3", 
    "oWEB": 
        { 
            "primary_account_number": "45454544444444", 
            "expiration_date": "2502", 
            "card_security_code": "123" 
        }, 
    "card_holder": 
        { 
            "front_name": "Juan Lopez", 
            "birth_date": "01011990", 
            "email": "[e-mail]", 
            "telephone": 1132840000, 
            "document_type": "DNI", 
            "document_number": "99999", 
            "notification": false 
        }, 
    "purchase_list": [ 
        { 
            "merchant_code_group": "grupo", 
            "access_key_merchant_code_group": "xxxxxxx-xxxx-x-xxxxx", 
            "transaction_amount": 1000, 
            "installments_plan": 0, 
            "installments": 1, 
            "transaction_currency_code": "032", 
            "seller_descriptor": "TEST_V3" 
        } 
    ], 
    "is_scoring_required": false, 
    "max_risk_score": 0, 
    "is_payment_guaranteeable": false
}