Link de Pago

8 min

Creación de la Orden de Pago

POST

https://api.mobbex.com/p/payment_order

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.mobbex.com/p/payment_order",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{ \n\t\"total\":100,\n\t\"description\":\"Some Description 3\",\n\t\"actions\": [{\n\t\t\"icon\": \"attachment\",\n\t\t\"title\": \"Factura\",\n\t\t\"url\": \"https://speryans.com/mifactura/123\"\n\t}],\n\t\"reference\": \"mi_referencia_123\"\n}",
  CURLOPT_HTTPHEADER => array(
    "Content-Type: application/json",
    "cache-control: no-cache",
    "x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc",
    "x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj",
    "x-lang: es"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Ejemplos del nodo actions:

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

Ejemplos del nodo items:

{
    "items": [
        {
            "image": "https://www.mobbex.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"]
}

Mostrar planes especiales basado en Reglas Avanzadas:

{
    "installments": ["+uid:kCbnpZB7B"]
}

Para conocer las opciones disponibles de medios de pago sources y planes installments ver Métodos de pago y cuotas

Para el caso especial de los Planes Ahora ( Argentina ) las referencias siempre serán fijas: ahora_3, ahora_6, 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 Mobbex 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.mobbex.com/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.mobbex.com/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.mobbex.com/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.mobbex.com/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.mobbex.com/p/payment_order/{ID}/paid

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

Postman

Descargar POSTMAN