API Doc
Space shortcuts
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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

json de ejemplo 
{
  "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


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 ) con el  medio de pago Id deseado 97 o 98 (rapipago, pagofacil)



json sin type y sin media_payments
{

  "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


json update type coupon
{
  "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


Una vez se imprime el cupon el pagador puede ir 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, y procede a realizar las notificaciones del que el pago se a realizado con exito  


NOTA: hasta el dia de la fecha 8/05/2019  la entidad de cupones con la que estamos operando de manera productiva es pagofacil, proximamente tendremos Rapipago






  • No labels