POST Ejecutar cobro grupal

Mediante este recurso se ejecuta el cobro de una operación con uno o mas medios de pago para uno o mas comercios

Descripción

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

El cobro de una operación genera una o mas transacciones que se estructuran de la siguiente forma:

1. Una operación contiene 1 o mas transacciones. El sistema pagoUno es quien se encarga de generar todas las transacciones que forman parte del cobro.

2. En una operación pueden definirse uno o mas medios de pago

   1. Elprimary_account_number_list permite definir mas de medio de pago por operación para distribuir el cobro entre varias tarjetas

3. Para cada tarjeta pueden definirse uno o mas comercios

   1. El purchase_listpermite definir mas de un comercio por tarjeta (definida en 2) para distribuir los fondos entre varias cuentas recaudadoras permitiendo así lo que comúnmente se conoce como "split"

4. Si se emplean mas de un medio de pago o mas de un comercio, la operación de cobro se distribuye en mas de una transacción

   1. Siempre cada transacción individual retornará un numero único de identificación (id) útil para efectuar consultas o ajustes sobre la transacción

   2. Si alguna de las transacciones individuales falla TODA LA OPERACIÓN de COBRO FALLA, y el sistema se encargará automáticamente de reversar las transacciones intermedias que hayan sido exitosas individualmente

En el BODY viaja una lista de tarjetas (Token) y ésta a su vez contiene una lista de compras (comercio-monto-plan-cuota-moneda-datos del vendedor) que conforman cada componente del cobro a ejecutar sobre cada tarjeta.

Si Ud. desea ofrecer a sus clientes la posibilidad de pagar una misma operación con mas de un medio de pago, la lista de tarjetas tendrá mas de una componente y para cada tarjeta deberá indicar cuanto paga y a que comercio le corresponde ese cobro.

• Si Ud. no requiere abrir su cobro en varias tarjetas, la lista de tarjetas tendrá una sola componente

Si Ud. necesita realizar una apertura del cobro a fin de distribuir los fondos en diferentes comercios, la lista de compras tendrá mas de una componente.

• Si Ud. no requiere splitear su recaudación en varios comercios, la lista de compras tendrá una sola componente

Valores para Programa Ahora

Al momento de Implementar el Programa Ahora debe tener en cuenta que el valor a enviar en el campo installments debe ser distinto al valor que se emplea en una venta estándar en cuotas

Lista de Valores Visible para el Cliente	Valor que se debe enviar en el campo installments	Descripción
Ahora 3	13	Venta en 3 Cuotas con el Programa Ahora
3	3	Venta estándar en 3 cuotas
Ahora 6	16	Venta en 6 Cuotas con el Programa Ahora
6	6	Venta estándar en 6 cuotas
Ahora 12	7	Venta en 12 Cuotas con el Programa Ahora
12	12	Venta estándar en 12 cuotas
Ahora 18	8	Venta en 18 Cuotas con el Programa Ahora
18	18	Venta estándar en 18 cuotas

¿Cuáles son las tasas del programa y cómo cobrar?

Para obtener más detalles sobre el programa ahora, visite el sitio oficial de argentina.gob.ar: https://www.argentina.gob.ar/ahora-12/comerciantes

/purchasegroup

POST https://api.pagouno.com/v1/Transaction/purchasegroup

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

Headers

Name	Type	Description
Content-Type*	string	application/json
Authorization*	string	Llave de Acceso Privada de la Entidad otorgada por EntradaUno

Request Body

Name	Type	Description
transaction_group_type*	number	Valor Permitido: 1
customer_transaction_identificator*	string	Campo descriptivo para la Identificación de la Entidad dentro de pagoUno (external_reference).
primary_account_number_list*	array	Lista de Tarjetas. Contiene el Token de la tarjeta generado en el paso previo y la lista de compras que se abonan con dicha tarjeta. Es obligatorio tener al menos un elemento en esta lista
token_id*	string	Token generado en el primer paso. No se podrá ingresar un token utilizado anteriormente.
purchase_list*	array	Lista de Compra. Es obligatorio tener al menos un elemento en esta lista.
merchant_code_group*	string	Grupo de Códigos de Comercio.
transaction_amount*	number	Monto de la transacción. Importe mínimo: 1000 ($10) El monto debe escribirse sin puntos ni coma. Los últimos dos dígitos siempre representan la parte decimal. Ejemplo: 1234 = $12.34
subscription_code	string	Código de Suscripción. Opcional. Solo debe ser enviado en pagos recurrentes. El cliente debe estar habilitado para operar con pagos recurrentes y se le entregará el código de acuerdo al tipo de suscripción requerida
installments_plan*	number	Valor permitido: 0
installments*	number	Cantidad de Cuotas. Valor Mínimo: 1 Valor Máximo: 99 IMPORTANTE: ver "Valores para Programa Ahora"
transaction_currency_code*	string	Valor Permitido: 032 El Valor 032 corresponde a la moneda local de la República Argentina (ARS)
seller_descriptor*	string	Datos del Vendedor. 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

200

Aprobada
--------
{
    "status": 200,
    "message": "",
    "data": {
        "success": true,
        "pending": false,
        "request": [
            {
                "id": "1236122C-CE3D-4C66-B99D-6E4F56C3E48A",
                "transaction_amount": 1000,
                "card": "Visa",
                "bin": "454545",
                "last_4_digits": "8745",
                "result_code": 0,
                "result_code_identifier": "SUCCESS"
            }
        ],
        "response": [
            {
                "result_code": 0,
                "result_code_identifier": "SUCCESS",
                "id": "1236122C-CE3D-4C66-B99D-6E4F56C3E48A",
                "success": true,
                "seller_descriptor": "P1*TEST 202006301148     ",
                "message": "APROBADA  (authno) Operación aprobada",
                "merchant_code": "10000007",
                "merchant_code_terminal": "90000007",
                "authorization": "000011",
                "ticket_number": "0001",
                "batch_number": "038",
                "transaction_amount": 1000,
                "capture_date": "0630",
                "account_number": "500000000778",
                "bin": "454545",
                "last_4_digits": "8745",
                "primary_account_token": "XXXXXXXX-XXXX-XXXX-XXXX-6XXF56C3E4XX",
                "validation_raw": "VTE0011",
                "validation": null
            }
        ]
    }
}
   
Denegada
--------
{
    "status": 200,
    "message": "",
    "data": {
        "success": false,
        "pending": false,
        "request": [
            {
                "id": "123F6F45-59D6-4313-A448-2EE40CAB9ACD",
                "transaction_amount": 10,
                "card": "Visa",
                "bin": "454545",
                "last_4_digits": "4444",
                "result_code": 0,
                "result_code_identifier": "SUCCESS"
            }
        ],
        "response": [
            {
                "result_code": 0,
                "result_code_identifier": "SUCCESS",
                "id": "123F6123-59D6-4313-A448-2EE40CAB9ACD",
                "success": false,
                "seller_descriptor": "P1C1c1*TEATRO UNO        ",
                "message": "DENEGADA ",
                "merchant_code": "12303707",
                "merchant_code_terminal": "97115807",
                "authorization": "",
                "ticket_number": "0355",
                "batch_number": "024",
                "transaction_amount": 10,
                "capture_date": "0413",
                "account_number": "008886060229",
                "bin": "454545",
                "last_4_digits": "4444"
            }
        ]
    }
}

Monto Invalido
--------------
{
    "status": 200,
    "message": "",
    "data": {
        "success": false,
        "pending": false,
        "request": [
            {
                "id": "123B19EB-46D3-4A2E-BD67-CB024AC404AF",
                "transaction_amount": 0,
                "card": "Visa",
                "bin": "454545",
                "last_4_digits": "4444",
                "result_code": 0,
                "result_code_identifier": "SUCCESS"
            }
        ],
        "response": [
            {
                "result_code": 0,
                "result_code_identifier": "SUCCESS",
                "id": "123B19EB-46D3-4A2E-BD67-CB024AC404AF",
                "success": false,
                "seller_descriptor": "P1C1c1*TEATRO UNO        ",
                "message": "MONTO INVALIDO Verificar el sistema, error en el formato del campo importe ",
                "merchant_code": "12303207",
                "merchant_code_terminal": "97115807",
                "authorization": "",
                "ticket_number": "0355",
                "batch_number": "024",
                "transaction_amount": 0,
                "capture_date": "0413",
                "account_number": "009885060233",
                "bin": "454545",
                "last_4_digits": "4444"
            }
        ]
    }
}

Sin Disponibilidad de Terminales
---------------------------------
{
    "status": 200,
    "message": "",
    "data": {
        "success": false,
        "pending": false,
        "request": [
            {
                "id": "",
                "transaction_amount": 100,
                "card": "Visa",
                "bin": "454545",
                "last_4_digits": "4444",
                "result_code": -100,
                "result_code_identifier": "TERMINAL_NOT_AVAILABLE"
            }
        "response": []
    }
}

Token id Inválido
-----------------
{
    "status": 400,
    "message": "bad request",
    "data": null
} 

Api Key Inválida
----------------
{
    "status": 403,
    "message": "not authorized",
    "data": null
} 

Ejemplos

Sin split

{
    "transaction_group_type": 1,
    "customer_transaction_identificator": "C-123456",
    "primary_account_number_list": [
        {
            "token_id": "1233D7C0-1245-48AA-A6D2-DD3D6EF303C9",
            "purchase_list": [
                {
                    "merchant_code_group": "MG-03207",
                    "transaction_amount": 1000,
                    "installments_plan": 0,
                    "installments": 1,
                    "transaction_currency_code": "032",
                    "seller_descriptor": "P1C1c1*Teatro UNO"
                }
            ]
        }
    ]
}

Con Split en dos comercios

{
    "transaction_group_type": 1,
    "customer_transaction_identificator": "C-123456",
    "primary_account_number_list": [
        {
            "token_id": "1233D7C0-1245-48AA-A6D2-DD3D6EF303C9",
            "purchase_list": [
                {
                    "merchant_code_group": "MER-GR01",
                    "access_key_merchant_code_group":"XXXXX",
                    ...
                },
                {
                    "merchant_code_group": "MER-GR02",
                    "access_key_merchant_code_group":"YYYYY",
                    ...
                }
            ]
        }
    ]
}

Pagos recurrentes

Para emplear la utilidad de pagos recurrentes se deberá habilitar el servicio en EntradaUno y solicitar el subscription_code adecuado para su operatoria

{
    "transaction_group_type": 1,
    "customer_transaction_identificator": "C-123456",
    "primary_account_number_list": [
        {
            "token_id": "1233D7C0-1245-48AA-A6D2-DD3D6EF303C9",
            "purchase_list": [
                {
                    "merchant_code_group": "MG-03207",
                    "transaction_amount": 1000,
                    "subscription_code": "MENSUAL",
                    "installments_plan": 0,
                    "installments": 1,
                    "transaction_currency_code": "032",
                    "seller_descriptor": "P1C1c1*Teatro UNO"
                }
            ]
        }
    ]
}