---
title: Métodos de Pago y Cuotas
slug: metodos-de-pago-y-cuotas
description: Learn how to work with the Mobbex API in JavaScript! This document covers everything you need to know about listing payment methods, obtaining payment plans with advanced rules, and retrieving payment method images. It also includes implementation instruc
icon: {"faIcon":"fa-brands fa-cc-mastercard"}
docTags: 
createdAt: 2021-01-25T14:21:29.000Z
---

# Listados de Medios de Pago

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.mobbex.com/p/sources?total={total}",
  "name": "Listar medios de pago con API-Keys",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "total",
        "type": "string",
        "description": "Importe total de la operación sobre el cual se calcularan las distintas modalidades de cuotas en cada medio de pago."
      },
      {
        "kind": "optional",
        "name": "sources[]",
        "type": "Array",
        "description": "Permite filtrar los medios de pago a listar"
      },
      {
        "kind": "optional",
        "name": "installments[]",
        "type": "Array",
        "description": "Permite filtrar cuotas"
      },
      {
        "kind": "optional",
        "name": "intent",
        "type": "string",
        "description": "Tipo de operatoria de la operación. Ver documentación sobre operatoria en 2 pasos."
      },
      {
        "kind": "optional",
        "name": "context",
        "type": "string",
        "description": "Contexto del Pago. Por defecto Checkout. Ver más en: https://mobbex.dev/consulta-de-operaciones#al-tipos-de-contextos"
      }
    ],
    "headerParameters": [
      {
        "kind": "required",
        "name": "x-api-key",
        "type": "string",
        "description": "Api key de su aplicación creada en el Portal de Desarrolladores de Mobbex."
      },
      {
        "kind": "required",
        "name": "x-access-token",
        "type": "string",
        "description": "Token de acceso a su entidad."
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "mQd9LGTf650Uk5WcW3gFk",
        "code": "{\n    \"result\": true,\n    \"data\": [\n        {\n            \"installments\": {\n                \"enabled\": true,\n                \"list\": []\n            },\n            \"view\": {\n                \"group\": \"card\",\n                \"subgroup_title\": \"Tarjeta de Crédito/Débito\",\n                \"subgroup_logo\": \"https://res.mobbex.com/images/icons/card.png\",\n                \"type\": \"card\",\n                \"subgroup_priority\": 99\n            },\n            \"source\": {\n                \"reference\": \"visa.naranja\",\n                \"name\": \"Visa Tarjeta Naranja\"\n            }\n        },\n        {\n            \"installments\": {\n                \"enabled\": false\n            },\n            \"view\": {\n                \"group\": \"cash\",\n                \"subgroup_title\": \"Efectivo\",\n                \"subgroup_logo\": \"https://res.mobbex.com/images/icons/cash.png\",\n                \"type\": \"selector\",\n                \"subgroup_priority\": 99\n            },\n            \"source\": {\n                \"reference\": \"arg.pagofacil\",\n                \"name\": \"PagoFacil\"\n            }\n        },\n        {\n            \"installments\": {\n                \"enabled\": true,\n                \"list\": [\n                    {\n                        \"name\": \"1 cuota\",\n                        \"description\": \"\",\n                        \"count\": 1,\n                        \"reference\": \"1\",\n                        \"uid\": \"65Am_YYqo\",\n                        \"totals\": {\n                            \"currency\": {\n                                \"value\": \"ARS\",\n                                \"label\": \"Peso Argentino\",\n                                \"symbol\": \"$\",\n                                \"hidden\": false\n                            },\n                            \"installment\": {\n                                \"amount\": 100,\n                                \"count\": 1\n                            },\n                            \"total\": 100,\n                            \"financial\": {\n                                \"percentage\": 0,\n                                \"amount\": 0\n                            }\n                        }\n                    },\n                    {\n                        \"name\": \"Ahora 3\",\n                        \"description\": \"\",\n                        \"count\": 3,\n                        \"reference\": \"ahora_3\",\n                        \"uid\": \"FiRS7rm_z\",\n                        \"totals\": {\n                            \"currency\": {\n                                \"value\": \"ARS\",\n                                \"label\": \"Peso Argentino\",\n                                \"symbol\": \"$\",\n                                \"hidden\": false\n                            },\n                            \"installment\": {\n                                \"amount\": 33.33,\n                                \"count\": 3\n                            },\n                            \"total\": 100,\n                            \"financial\": {\n                                \"percentage\": 0,\n                                \"amount\": 0\n                            }\n                        }\n                    }\n            },\n            \"view\": {\n                \"group\": \"card\",\n                \"subgroup_title\": \"Tarjeta de Crédito/Débito\",\n                \"subgroup_logo\": \"https://res.mobbex.com/images/icons/card.png\",\n                \"type\": \"card\",\n                \"subgroup_priority\": 99\n            },\n            \"source\": {\n                \"reference\": \"visa\",\n                \"name\": \"Visa\"\n            }\n        }\n    ]\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "mQd9LGTf650Uk5WcW3gFk"
  },
  "examples": {
    "languages": [
      {
        "id": "OYtj3Z3lxV4C3dZNU6hJk",
        "code": "var xhr = new XMLHttpRequest();\nxhr.withCredentials = true;\n\nxhr.addEventListener(\"readystatechange\", function() {\n  if(this.readyState === 4) {\n    console.log(this.responseText);\n  }\n});\n\nxhr.open(\"GET\", \"https://api.mobbex.com/p/sources?total=100\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\n\nxhr.send();",
        "language": "javascript"
      },
      {
        "id": "fXb6q_Lt4RyB6Xh3bi7Pk",
        "code": "<?php\r\n\r\n$curl = curl_init();\r\n\r\ncurl_setopt_array($curl, array(\r\n  CURLOPT_URL => 'https://api.mobbex.com/p/sources?total=100',\r\n  CURLOPT_RETURNTRANSFER => true,\r\n  CURLOPT_ENCODING => '',\r\n  CURLOPT_MAXREDIRS => 10,\r\n  CURLOPT_TIMEOUT => 0,\r\n  CURLOPT_FOLLOWLOCATION => true,\r\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\r\n  CURLOPT_CUSTOMREQUEST => 'GET',\r\n  CURLOPT_HTTPHEADER => array(\r\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\r\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'\r\n  ),\r\n));\r\n\r\n$response = curl_exec($curl);\r\n\r\ncurl_close($curl);\r\necho $response;\r\n",
        "language": "php"
      }
    ],
    "selectedLanguageId": "OYtj3Z3lxV4C3dZNU6hJk"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Query Parameter",
    "value": "queryParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "listar-medios-de-pago-con-api-keys",
  "legacyHash": "xt3RDLR4_tBLVDRlwTi5N"
}
```
:::

**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

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



:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.mobbex.com/p/sources/rules/{rule}/installments",
  "name": "Obtener planes con Reglas Avanzadas",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "rule",
        "type": "string",
        "description": "Tipo de Regla que se desea obtener. Valores posibles: \"externalMatch\""
      }
    ],
    "headerParameters": [
      {
        "kind": "required",
        "name": "x-api-key",
        "type": "string",
        "description": "Clave API de su aplicación."
      },
      {
        "kind": "required",
        "name": "x-access-token",
        "type": "string",
        "description": "Token de Acceso a la entidad para la cual desea realizar la operación."
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "XrKfZU5pv-TMSYrR3J_jI",
        "code": "{\n    \"result\": true,\n    \"data\": [\n        {\n            \"sourceReference\": \"visa\",\n            \"installments\": [\n                {\n                    \"name\": \"12 cuotas\",\n                    \"description\": \"+10% de Descuento.\",\n                    \"uid\": \"kCbnpZB7B\"\n                }\n            ],\n            \"uid\": \"6CPxGdioK\",\n            \"source\": {\n                \"reference\": \"visa\",\n                \"name\": \"Visa\",\n                \"shortName\": \"Visa\"\n            }\n        }\n    ]\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "XrKfZU5pv-TMSYrR3J_jI"
  },
  "examples": {
    "languages": [
      {
        "id": "Y9uPYSq8SmpbP-ijbuOAd",
        "code": "var xhr = new XMLHttpRequest();\nxhr.withCredentials = true;\n\nxhr.addEventListener(\"readystatechange\", function() {\n  if(this.readyState === 4) {\n    console.log(this.responseText);\n  }\n});\n\nxhr.open(\"GET\", \"https://api.mobbex.com/p/sources/rules/externalMatch/installments\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\n\nxhr.send();",
        "language": "javascript"
      },
      {
        "id": "MS9QYzdOp-3lX4vdqekZb",
        "code": "",
        "language": "php"
      }
    ],
    "selectedLanguageId": "Y9uPYSq8SmpbP-ijbuOAd"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "obtener-planes-con-reglas-avanzadas",
  "legacyHash": "BZGE8Ae7PKsurEwLvYIgS"
}
```
:::



# 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.



:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://res.mobbex.com/images/sources/{reference}.{format}",
  "name": "Obtener imágen del medio de pago",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "reference",
        "type": "string",
        "description": "Referencia del método de pago obtenida desde la API del Listado."
      },
      {
        "kind": "required",
        "name": "format",
        "type": "string",
        "description": "El formato de la imagen. Sólo admite png o jpg"
      }
    ],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "_EjO3zlXW0QxeCsU0N9LB",
        "code": "",
        "language": "200"
      }
    ],
    "selectedLanguageId": "_EjO3zlXW0QxeCsU0N9LB"
  },
  "examples": {
    "languages": [
      {
        "id": "zYuDWInh3LdV9LhzS9s9J",
        "code": "curl --location --request GET 'https://res.mobbex.com/images/sources/visa.frances.png'",
        "language": "curl"
      }
    ],
    "selectedLanguageId": "zYuDWInh3LdV9LhzS9s9J"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Query Parameter",
    "value": "queryParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "obtener-imgen-del-medio-de-pago",
  "legacyHash": "Y4JoJCcsFTKfCyiNn_5Lm"
}
```
:::

