Que es?
Los pagos de tipo cupón (coupon) son solicitudes de pago que se pagan mediante las entidades de pagofacil o rapipago, es decir, la api emite un cupon con los datos del pago y numero de cupon (codigo de barra), el cual se puede imprimir.
El cupon se puede descargar mediante una url que la api devuelve cuando se logro generar el cupon con exito
Para lograr esto se debe enviar un POST a la apiv2 indicando el type coupon y un medio de pago valido 97 o 98, rapipago o pagofacil respetivamente
Generar solicitud de pago de tipo cupón (La información de cada campo se encuentra en el documento Crear un pago)
Se debe enviar POST a la apiv2, hay dos maneras de crear el cupon
1) Crear la solicitud de pago de cupon de manera directa
Enviando un post con la siguiente información mínima
{
"type": "coupon",
"collector_id": "Id",
"currency_id": "ARS",
"external_transaction_id": "ID",
"due_date": "2019-12-30T09:05:29-0300",
"payment_methods": [
{
"amount": 1,
"media_payment_id": 98
}
],
"details": [
{
"external_reference": "1",
"concept_id": "1",
"concept_description": "Prueba",
"amount": 1
}
],
"payer": {
"name": "Pagador de prueba",
"email": "test@test.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"metadata": {
"valor1": "123"
}
}
Respuesta
{
"type": "coupon",
"validation": false,
"review": false,
"id": "04e61140-07bd-4fd6-85d3-a5f4f8fa62ec",
"external_transaction_id": "1557324106049",
"collector_id": "999",
"collector_detail": {
"name": "PRUEBA"
},
"form_url": "http://servicios.paypertic.com/formularios/v2/pagos/04e61140-07bd-4fd6-85d3-a5f4f8fa62ec",
"details": [
{
"amount": 1,
"external_reference": "1",
"concept_id": "1",
"concept_description": "Prueba"
}
],
"currency_id": "ARS",
"payment_methods": [
{
"amount": 1,
"final_amount": 1,
"media_payment_id": 98,
"gateway": {
"transaction_id": "1f08aa57-485c-4ced-a07f-3165b34ba440"
},
"payment_method_id": 0,
"coupon_number": "197000000100193640000000000001000000000099"
}
],
"payer": {
"name": "Pagador de prueba",
"email": "test@test.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"final_amount": 1,
"status": "issued",
"status_detail": "Coupon Status - IN_PROCESS",
"request_date": "2019-05-08T11:01:46-0300",
"due_date": "2019-12-30T09:05:29-0300",
"last_due_date": "2019-12-30T09:05:29-0300",
"process_date": "2019-05-08T11:01:49-0300",
"last_update_date": "2019-05-08T11:01:49-0300",
"metadata": {
"valor1": "123"
}
}
campos destacables:
payment_methods.coupon_number : Es el numero de cupón generado
form_url: Url en la cual se puede visualizar el cupon
status_detail: Es el estado en el que esta el cupo generado
Vista default de un cupon de pagofacil
1) Crear la solicitud de pago abierto para luego establecer el medio de pago cupón
También es posible crear la solicitud de pago abierta (sin medio de pago y sin tipo) y agregarle después el type (coupon ) y el medio de pago Id deseado, 97 o 98 (rapipago, pagofacil)
{
"collector_id": "999",
"currency_id": "ARS",
"external_transaction_id": "id",
"due_date": "2019-12-30T09:05:29-0300",
"details": [
{
"external_reference": "1",
"concept_id": "1",
"concept_description": "Prueba",
"amount": 1
}
],
"payer": {
"name": "Pagador de prueba",
"email": "test@test.com",
"iedntification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"metadata": {
"valor1": "123"
}
}
Respuesta:
{
"validation": false,
"review": false,
"id": "335d5a22-8cab-474e-a7fa-617ee22f048f",
"external_transaction_id": "1557325464340",
"collector_id": "999",
"collector_detail": {
"name": "PRUEBA"
},
"form_url": "http://localhost:8080/formularios/v2/pagos/335d5a22-8cab-474e-a7fa-617ee22f048f",
"details": [
{
"amount": 1,
"external_reference": "1",
"concept_id": "1",
"concept_description": "Prueba"
}
],
"currency_id": "ARS",
"payer": {
"name": "Pagadordeprueba",
"email": "test@test.com"
},
"final_amount": 1,
"status": "pending",
"request_date": "2019-05-08T11:24:24-0300",
"due_date": "2019-12-30T09:05:29-0300",
"last_due_date": "2019-12-30T09:05:29-0300",
"last_update_date": "2019-05-08T11:24:24-0300",
"metadata": {
"valor1": "123"
}
}
campos destacables:
form_url: En este caso la url nos dirige a la web de pagos en donde podremos seleccionar la opción "Descargar cupon"
Al hacer click en "generar el cupón " la pagina muestra el cupon para poder imprimir
También es posible hacerlo mediante PUT json a https://api.paypertic.com/pagos/Id_del_pago
{
"type":"coupon",
"payment_methods": [
{
"amount": 1,
"media_payment_id": 98
}
]
}
Respuesta
{
"type": "coupon",
"validation": false,
"review": false,
"id": "335d5a22-8cab-474e-a7fa-617ee22f048f",
"external_transaction_id": "1557325464340",
"collector_id": "999",
"collector_detail": {
"name": "PRUEBA"
},
"form_url": "http://localhost:8080/formularios/v2/pagos/335d5a22-8cab-474e-a7fa-617ee22f048f",
"details": [
{
"amount": 1,
"external_reference": "1",
"concept_id": "1",
"concept_description": "Prueba"
}
],
"currency_id": "ARS",
"payment_methods": [
{
"amount": 1,
"final_amount": 1,
"media_payment_id": 98,
"gateway": {
"transaction_id": "ac44bfec-937d-444c-a3ec-70ff34cda8ed"
},
"coupon_number": "197000000100193640000000000001100000000016"
}
],
"payer": {
"id": "4fdca1f5-61b1-41f0-879a-3b9382f14c2a",
"name": "Pagadordeprueba",
"email": "test@test.com"
},
"final_amount": 1,
"status": "issued",
"status_detail": "Coupon Status - IN_PROCESS",
"request_date": "2019-05-08T11:24:24-0300",
"due_date": "2019-12-30T09:05:29-0300",
"last_due_date": "2019-12-30T09:05:29-0300",
"process_date": "2019-05-08T11:47:59-0300",
"last_update_date": "2019-05-08T11:47:59-0300",
"metadata": {
"valor1": "123"
}
}
campos destacables:
payment_methods.coupon_number : Es el numero de cupón generado (cadigo de barra )
form_url: Url a en la cual se puede visualizar el cupon
Una vez se imprime el cupon, el pagador puede ir a una terminal de pagofacil o rapipago, según corresponda, una vez realizado el pago, un servicio especial dedicado a este tipo de pagos procesa la información de manera online, el estado del pago cambio a approved y se envian las notificaciones