Métodos de Pago y Cuotas

3 min

Listados de Medios de Pago

Listar medios de pago con API-Keys

GET

https://api.mobbex.com/p/sources?total={total}

Query Parameters

totalstringrequired
Description
Importe total de la operación sobre el cual se calcularan las distintas modalidades de cuotas en cada medio de pago.
sources[]Array
Description
Permite filtrar los medios de pago a listar
installments[]Array
Description
Permite filtrar cuotas
intentstring
Description
Tipo de operatoria de la operación. Ver documentación sobre operatoria en 2 pasos.
contextstring
Description
Contexto del Pago. Por defecto Checkout. Ver más en: https://mobbex.dev/consulta-de-operaciones#al-tipos-de-contextos

Header Parameters

x-api-keystringrequired
Description
Api key de su aplicación creada en el Portal de Desarrolladores de Mobbex.
x-access-tokenstringrequired
Description
Token de acceso a su entidad.

javascript

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

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

xhr.open("GET", "https://api.mobbex.com/p/sources?total=100");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");

xhr.send();

php

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.mobbex.com/p/sources?total=100',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',
    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

200

{
    "result": true,
    "data": [
        {
            "installments": {
                "enabled": true,
                "list": []
            },
            "view": {
                "group": "card",
                "subgroup_title": "Tarjeta de Crédito/Débito",
                "subgroup_logo": "https://res.mobbex.com/images/icons/card.png",
                "type": "card",
                "subgroup_priority": 99
            },
            "source": {
                "reference": "visa.naranja",
                "name": "Visa Tarjeta Naranja"
            }
        },
        {
            "installments": {
                "enabled": false
            },
            "view": {
                "group": "cash",
                "subgroup_title": "Efectivo",
                "subgroup_logo": "https://res.mobbex.com/images/icons/cash.png",
                "type": "selector",
                "subgroup_priority": 99
            },
            "source": {
                "reference": "arg.pagofacil",
                "name": "PagoFacil"
            }
        },
        {
            "installments": {
                "enabled": true,
                "list": [
                    {
                        "name": "1 cuota",
                        "description": "",
                        "count": 1,
                        "reference": "1",
                        "uid": "65Am_YYqo",
                        "totals": {
                            "currency": {
                                "value": "ARS",
                                "label": "Peso Argentino",
                                "symbol": "$",
                                "hidden": false
                            },
                            "installment": {
                                "amount": 100,
                                "count": 1
                            },
                            "total": 100,
                            "financial": {
                                "percentage": 0,
                                "amount": 0
                            }
                        }
                    },
                    {
                        "name": "Ahora 3",
                        "description": "",
                        "count": 3,
                        "reference": "ahora_3",
                        "uid": "FiRS7rm_z",
                        "totals": {
                            "currency": {
                                "value": "ARS",
                                "label": "Peso Argentino",
                                "symbol": "$",
                                "hidden": false
                            },
                            "installment": {
                                "amount": 33.33,
                                "count": 3
                            },
                            "total": 100,
                            "financial": {
                                "percentage": 0,
                                "amount": 0
                            }
                        }
                    }
            },
            "view": {
                "group": "card",
                "subgroup_title": "Tarjeta de Crédito/Débito",
                "subgroup_logo": "https://res.mobbex.com/images/icons/card.png",
                "type": "card",
                "subgroup_priority": 99
            },
            "source": {
                "reference": "visa",
                "name": "Visa"
            }
        }
    ]
}

Formato de Respuesta en cada solicitud

result: Resultado de la operación

data: Array de datos de la operación.

Data

source: Posee los datos del medio de pago: nombre y referencia

view: Posee el tipo de Medio de Pago

installments: Nodo Opcional y sólo disponible en métodos de pago que poseen Cuotas. Array de Cuotas. Si el método posee cuotas encontrará un nodo "list"

Installments -> List

count: Cantidad real de Cuotas, es el divisor del monto total

name: Nombre del sistema de cuotas

description: Descripción opcional del sistema de cuotas.

totals: Nodo donde se indican los recargos, descuentos y cuotas

{
    "totals": {
        "currency": {
            "value": "ARS",
            "label": "Peso Argentino",
            "symbol": "$",
            "hidden": false
        },
        "installment": {
            "amount": 12500,
            "count": 1
        },
        "total": 12500,
        "financial": {
            "percentage": 0,
            "amount": 0
        }
    }
}

Obtener planes con Reglas Avanzadas

GET

https://api.mobbex.com/p/sources/rules/{rule}/installments

Query Parameters

rulestringrequired
Description
Tipo de Regla que se desea obtener. Valores posibles: "externalMatch"

Header Parameters

x-api-keystringrequired
Description
Clave API de su aplicación.
x-access-tokenstringrequired
Description
Token de Acceso a la entidad para la cual desea realizar la operación.

javascript

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

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

xhr.open("GET", "https://api.mobbex.com/p/sources/rules/externalMatch/installments");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");

xhr.send();

php

200

{
    "result": true,
    "data": [
        {
            "sourceReference": "visa",
            "installments": [
                {
                    "name": "12 cuotas",
                    "description": "+10% de Descuento.",
                    "uid": "kCbnpZB7B"
                }
            ],
            "uid": "6CPxGdioK",
            "source": {
                "reference": "visa",
                "name": "Visa",
                "shortName": "Visa"
            }
        }
    ]
}

Imágenes de Métodos de Pago

Los métodos de pago posee un nodo llamado "reference" que identifica los métodos de pago en Mobbex. Para obtener las imágenes se debe utilizar este nodo.

Obtener imágen del medio de pago

GET

https://res.mobbex.com/images/sources/{reference}.{format}

Query Parameters

referencestringrequired
Description
Referencia del método de pago obtenida desde la API del Listado.
formatstringrequired
Description
El formato de la imagen. Sólo admite png o jpg

curl

curl --location --request GET 'https://res.mobbex.com/images/sources/visa.frances.png'

200