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:
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.
En una operación pueden definirse uno o mas medios de pago
El
primary_account_number_listpermite definir mas de medio de pago por operación para distribuir el cobro entre varias tarjetas
Para cada tarjeta pueden definirse uno o mas comercios
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"
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
Siempre cada transacción individual retornará un numero único de identificación (id) útil para efectuar consultas o ajustes sobre la transacción
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
Content-Type*
string
application/json
Authorization*
string
Llave de Acceso Privada de la Entidad otorgada por EntradaUno
Request Body
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
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"
}
]
}
]
}Última actualización
¿Te fue útil?