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 numero de cupon con el cual se debe ir a una terminal de la entidad correspondiente
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 a en la cual se puede visualizar el cupo
status_detail: Es el estado en el que esta el cupo generado
1) Crear la solicitud de pago abierto para luego establecer el medio de pago cupon
También es posible crear el la solicitud de pago abierta (sin medio de pago) y agregarle después el type (coupon ) con 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 generar el cupón la pagina nos genera el cupón y lo muestra para poder descargar o 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
form_url: url a en la cual se puede visualizar el cupo