Link de Pago

6 min

Creación de la Orden de Pago

POST

https://api.unicobros.com.ar/p/payment_order

curl -X POST \
  https://napi.mobbex.com/p/payment_order \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -H 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
  -H 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
  -H 'x-lang: es' \
  -d '{
    "total": 100,
    "description": "Some Description #3",
    "due": {
      "day": 18,
      "month": 4,
      "year": 2021
    },
    "secondDue":{
        "days": 10,
        "surcharge": 30
    },
    "actions": [
        {
            "icon": "attachment",
            "title": "Factura",
            "url": "https://speryans.com/mifactura/123",
        },
    ],
    "return_url": "https://unicobros.com/order123/return",
    "webhook": "https://unicobros.com/order123/webhook",
    "reference": "mi_referencia_123",
    "options":{
        "smsMessage": "Enviamos la orden generada para su pago"
    }
}'

Ejemplos del nodo actions:

"actions": [
    {
        "icon": "document",
        "title": "Factura",
        "url": "https://unicobros.com/mifactura/123"
    },
    {
        "icon": "attachment",
        "title": "Factura 2",
        "url": "https://unicobros.com/mifactura/1234"
    }
]

Ejemplos del nodo items:

{
    "items": [
        {
            "image": "https://www.unicobros.com/wp-content/uploads/2019/03/web_logo.png",
            "quantity": 2,
            "description": "Mi Producto",
            "total": 50
        }
    ]
}

Las imágenes deben soportar HTTPS, de lo contrario no serán mostradas.

Ejemplos del nodo sources:

{
    "sources": ["visa", "mastercard"]
}

Ejemplos del nodo installments:

Existen 3 formas de limitar los planes en base a su reference:

Limitar los Planes únicamente a los elegidas en el Array:

{
    "installments": ["1", "3", "ahora_12"]
}

Ocultar determinados planes de todo el conjunto de planes existentes:

{
    "installments": ["-ahora_12", "-ahora_18"]
}

Atributo "reference"

Este atributo es utilizado para evitar pagos duplicados. Debe ser único para cada operación de pago a identificar, ya que Unicobros NO permitirá 2 transacciones en estado "Pago" con el mismo reference.

Reenviar Orden de Pago

Esta API permite reenviar la orden de pago a través de email o teléfono definido en la misma

POST

https://api.unicobros.com.ar/p/payment_order/resend

var data = JSON.stringify({
    id: "JlwOU4dzj"
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
    if (this.readyState === 4) {
        console.log(this.responseText);
    }
});

xhr.open("POST", "https://api.unicobros.com.ar/p/payment_order/resend");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
xhr.setRequestHeader("x-lang", "es");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("cache-control", "no-cache");

xhr.send(data);

Eliminar Orden de Pago

DELETE

https://api.unicobros.com.ar/p/payment_order/{ID}

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
    if (this.readyState === 4) {
        console.log(this.responseText);
    }
});

xhr.open("DELETE", "https://api.unicobros.com.ar/p/payment_order/JlwOU4dzj");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
xhr.setRequestHeader("x-lang", "es");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("cache-control", "no-cache");

xhr.send();

Marcar una Orden de Pago como Paga

POST

https://api.unicobros.com.ar/p/payment_order/{ID}/paid

curl --location --request POST 'https://api.unicobros.com.ar/p/payment_order/JlwOU4dzj/paid' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'