---
title: Ejecuciones
slug: ejecuciones
description: Learn how to manually execute subscriptions using the Mobbex API with this comprehensive document. Includes code examples in JavaScript, Node.js, and PHP, as well as instructions for bulk manual payments. Explore webhooks, including new subscription data,
icon: {"faIcon":"fa-solid fa-money-bill-transfer"}
docTags: 
createdAt: 2021-01-25T14:18:53.000Z
---

Monto de la operación. Formato XXX.xx donde el PUNTO es el separador decimal.

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/subscriber/{sid}/execution",
  "name": "Ejecutar Suscripción Manualmente",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción."
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "ID del suscriptor."
      }
    ],
    "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": "iq2V_iuDLGbmX99oahiaM",
        "code": "{\n    \"result\": true,\n    \"data\": {}\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "iq2V_iuDLGbmX99oahiaM"
  },
  "examples": {
    "languages": [
      {
        "id": "5GqYmWmoCJOfgm4CGYApV",
        "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.unicobros.com.ar/p/subscriptions/T691POMK62SGC7CHAK/subscriber/Y7B3P541B9VFBYTHSZ/execution\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\n\nxhr.send();",
        "language": "javascript"
      },
      {
        "id": "N4ob5lxq904W3tqqnu-00",
        "code": "var request = require('request');\nvar options = {\n  'method': 'GET',\n  'url': 'https://api.unicobros.com.ar/p/subscriptions/T691POMK62SGC7CHAK/subscriber/Y7B3P541B9VFBYTHSZ/execution',\n  'headers': {\n    'x-api-key': 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token': 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc'\n  }\n};\nrequest(options, function (error, response) {\n  if (error) throw new Error(error);\n  console.log(response.body);\n});\n",
        "language": "nodejs"
      },
      {
        "id": "Oh0f1WJC_i9uDCZrBp1Dk",
        "code": "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => 'https://api.unicobros.com.ar/p/subscriptions/T691POMK62SGC7CHAK/subscriber/Y7B3P541B9VFBYTHSZ/execution',\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => '',\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 0,\n  CURLOPT_FOLLOWLOCATION => true,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => 'GET',\n  CURLOPT_HTTPHEADER => array(\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'\n  ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;\n",
        "language": "php"
      }
    ],
    "selectedLanguageId": "Oh0f1WJC_i9uDCZrBp1Dk"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "autoGeneratedAnchorSlug": "ejecutar-suscripcin-manualmente",
  "legacyHash": "aIu_sySm0Q0bSaX68xzav"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/subscriber/{sid}/execution",
  "name": "Ejecutar Suscripción Manualmente con Monto Diferenciado",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción"
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "ID del suscriptor"
      }
    ],
    "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": [
      {
        "kind": "optional",
        "name": "total",
        "type": "Number",
        "description": "Total a cobrar al suscriptor. Si no se envia se cobrará el monto asignado al Suscriptor ( Monto personalizado por Suscriptor ) o el monto de la Suscripción. Formato XXX.xx donde el PUNTO es el separador decimal."
      },
      {
        "kind": "optional",
        "name": "reference",
        "type": "string",
        "description": "Referencia del Cobro a Ejecutar. Esta referencia deberá ser única.",
        "": "optional"
      },
      {
        "kind": "optional",
        "name": "test",
        "type": "Boolean",
        "description": "Activa el modo de pruebas para la ejecución."
      },
      {
        "name": "source",
        "kind": "optional",
        "type": "string",
        "description": "Siempre que el suscriptor tenga adherida una tarjeta alternativa, se podrá seleccionar sobre que tarjeta generar el cobro manual.\nValores admitidos: \"primary\" / \"secondary\".",
        "children": []
      },
      {
        "name": "description",
        "kind": "optional",
        "type": "string",
        "description": "Permite definir una descripción para el cobro a realizar, el cual será visualizado en el listado de operaciones.",
        "": "Permite definir una descripción para el cobro a realizar, el cual será visualizado en el listado de operaciones."
      },
      {
        "name": "softDescriptor",
        "kind": "optional",
        "type": "string",
        "description": "Permite definir una descripción para el cobros, visible por el tarjeta-habiente en su resumen (dependiente de su banco emisor). Utilice este campo solo en casos requeridos. Longitud máxima 25 caracteres.",
        "": "Permite definir una descripción para el cobros, visible por el tarjeta-habiente en su resumen (dependiente de su banco emisor). Utilice este campo solo en casos requeridos. Longitud máxima 25 caracteres."
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "dAFGxoMAzlN9DzSWTdqg-",
        "code": "{\n    \"result\": true,\n    \"data\": {}\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "dAFGxoMAzlN9DzSWTdqg-"
  },
  "examples": {
    "languages": [
      {
        "id": "SI-P-SPeD0RM525QAF5QF",
        "code": "var data = JSON.stringify({\"total\":150,\"reference\":\"230320211305\",\"description\":\"Cobro con una descripción diferente\"});\n\nvar 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(\"POST\", \"https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/subscriber/Y7B3P541B9VFBYTHSZ/execution\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nxhr.setRequestHeader(\"Content-Type\", \"application/json\");\n\nxhr.send(data);",
        "language": "javascript"
      },
      {
        "id": "Ndz9siq7956OV3DwKLoCS",
        "code": "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => 'https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/subscriber/Y7B3P541B9VFBYTHSZ/execution',\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => '',\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 0,\n  CURLOPT_FOLLOWLOCATION => true,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => 'POST',\n  CURLOPT_POSTFIELDS =>'{\n    \"total\": 150,\n    \"reference\": \"230320211305\",\n    \"description\": \"Cobro con una descripción diferente\"\n}',\n  CURLOPT_HTTPHEADER => array(\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',\n    'Content-Type: application/json'\n  ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;\n",
        "language": "php"
      }
    ],
    "selectedLanguageId": "Ndz9siq7956OV3DwKLoCS"
  },
  "description": "El monto con el que se ejecuta la suscripción puede ser diferente al definido en la suscripción o el suscriptor.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "ejecutar-suscripcin-manualmente-con-monto-diferenc",
  "legacyHash": "3SvmkHsDgTWqd79pDVxNc"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/action/execute",
  "name": "Ejecutar cobros manuales masivamente",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción"
      }
    ],
    "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": [
      {
        "kind": "required",
        "name": "",
        "type": "Array",
        "description": "El body es un Array de Objetos de Tipo JSON"
      },
      {
        "kind": "required",
        "name": "",
        "type": "Object",
        "description": "Objeto con los datos del suscriptor a cobrar"
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "Identificador del Suscriptor"
      },
      {
        "kind": "optional",
        "name": "total",
        "type": "Number",
        "description": "Monto de la operación. Formato XXX.xx donde el PUNTO es el separador decimal."
      },
      {
        "kind": "required",
        "name": "reference",
        "type": "string",
        "description": "Referencia que identifique el cobro al suscriptor."
      },
      {
        "kind": "optional",
        "name": "description",
        "type": "string",
        "description": "Permite personalizar la descripción del Cobro."
      },
      {
        "kind": "optional",
        "name": "test",
        "type": "Boolean",
        "description": "Marca la ejecución como Prueba. Valores aceptados: true / false. Defecto: false"
      },
      {
        "name": "source",
        "kind": "optional",
        "type": "string",
        "description": "Siempre que el suscriptor tenga adherida una tarjeta alternativa, se podrá seleccionar sobre que tarjeta generar el cobro manual.\nValores admitidos: \"primary\" / \"secondary\".",
        "children": []
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "17KymH4jciKmTArqr35Fp",
        "code": "{\n    \"result\": true\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "17KymH4jciKmTArqr35Fp"
  },
  "examples": {
    "languages": [
      {
        "id": "yKtet8XlA1JYHZUdCE5Ar",
        "code": "var data = JSON.stringify([\n  {\"sid\":\"Y7B3P541B9VFBYTHSZ\",\"total\":10,\"reference\":\"230320211348\"}\n  ]);\n\nvar 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(\"POST\", \"https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/action/execute\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nxhr.setRequestHeader(\"Content-Type\", \"application/json\");\n\nxhr.send(data);",
        "language": "javascript"
      },
      {
        "id": "zn3YNWnuGJ-4vALV7LUyP",
        "code": "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => 'https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/action/execute',\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => '',\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 0,\n  CURLOPT_FOLLOWLOCATION => true,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => 'POST',\n  CURLOPT_POSTFIELDS =>'[\n    {\n        \"sid\": \"Y7B3P541B9VFBYTHSZ\",\n        \"total\": 10,\n        \"reference\": \"230320211348\"\n    }\n]',\n  CURLOPT_HTTPHEADER => array(\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',\n    'Content-Type: application/json'\n  ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;",
        "language": "php"
      }
    ],
    "selectedLanguageId": "zn3YNWnuGJ-4vALV7LUyP"
  },
  "description": "Permite ejecutar cobros masivos dentro de una misma suscripción. Tenga en cuenta que esta API solamente retornará que el proceso fue aceptado exitosamente. La ejecución se realizará de fondo y se notificará via Webhooks.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "ejecutar-cobros-manuales-masivamente",
  "legacyHash": "YP_lMPLQPXPaRyR61KsVT"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/subscriber/{sid}/action/schedule",
  "name": "Programar una ejecución a futuro",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción"
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "ID del suscriptor"
      }
    ],
    "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": [
      {
        "kind": "required",
        "name": "date",
        "type": "Object",
        "description": "Objecto con la fecha de ejecución futura. La fecha definida debe ser al menos 4 días posterior a la fecha actual."
      },
      {
        "kind": "required",
        "name": "date.day",
        "type": "Integer",
        "description": "Día a agendar."
      },
      {
        "kind": "required",
        "name": "date.month",
        "type": "Integer",
        "description": "Mes a agendar."
      },
      {
        "kind": "required",
        "name": "date.year",
        "type": "Integer",
        "description": "Año a agendar."
      },
      {
        "kind": "optional",
        "name": "total",
        "type": "Number",
        "description": "Total específico a cobrar al suscriptor. Si no se envía se cobrará el monto asignado al Suscriptor ( Monto personalizado por Suscriptor ) o el monto de la Suscripción."
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "FvZCY5IUP28bMG4x9DtxT",
        "code": "{\n    \"result\"\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "FvZCY5IUP28bMG4x9DtxT"
  },
  "examples": {
    "languages": [
      {
        "id": "KHp6My7wA_tTn_vx1G5_T",
        "code": "var data = JSON.stringify({\n  \"date\": {\n    \"day\": 10,\n    \"month\": 4,\n    \"year\": 2021\n  }\n});\n\nvar 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(\"POST\", \"https://api.unicobros.com.ar/p/subscriptions/u5485JkgTy/subscriber/5sfTy4iPlT/action/schedule\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nxhr.setRequestHeader(\"Content-Type\", \"application/json\");\n\nxhr.send(data);",
        "language": "javascript"
      },
      {
        "id": "3vNq9bI0ofseLZnrXAgJ2",
        "code": "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => 'https://api.unicobros.com.ar/p/subscriptions/u5485JkgTy/subscriber/5sfTy4iPlT/action/schedule',\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => '',\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 0,\n  CURLOPT_FOLLOWLOCATION => true,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => 'POST',\n  CURLOPT_POSTFIELDS =>'{\n    \"date\": {\n        \"day\": 10,\n        \"month\": 4,\n        \"year\": 2021\n    }\n}',\n  CURLOPT_HTTPHEADER => array(\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',\n    'Content-Type: application/json'\n  ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;\n",
        "language": "php"
      }
    ],
    "selectedLanguageId": "3vNq9bI0ofseLZnrXAgJ2"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "programar-una-ejecucin-a-futuro",
  "legacyHash": "PXa2WiIkElPS-pGPzH_20"
}
```
:::

## Acciones sobre una ejecución

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/subscriber/{sid}/execution/{eid}/action/retry",
  "name": "Reintentar una Ejecución",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción"
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "ID del suscriptor"
      },
      {
        "kind": "required",
        "name": "eid",
        "type": "string",
        "description": "ID de la ejecución a reintentar"
      }
    ],
    "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": "PHQYop37HChyAU8_XmTM9",
        "code": "{\n    \"result\": true\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "PHQYop37HChyAU8_XmTM9"
  },
  "examples": {
    "languages": [
      {
        "id": "waaJAtkBb4gNaByvFnCYI",
        "code": "var data = JSON.stringify({\"date\":{\"day\":28,\"month\":5,\"year\":2021}});\n\nvar 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(\"POST\", \"https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/subscriber/Y7B3P541B9VFBYTHSZ/execution/JS73P5HG8AVFBYT45Z/action/retry\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nxhr.setRequestHeader(\"Content-Type\", \"application/json\");\n\nxhr.send(data);",
        "language": "javascript"
      },
      {
        "id": "9a-T_XqXj1iZKIVi3kA9A",
        "code": "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n  CURLOPT_URL => 'https://api.unicobros.com.ar/p/subscriptions/R89BLVMZRPDH3GMRH9/subscriber/Y7B3P541B9VFBYTHSZ/execution/JS73P5HG8AVFBYT45Z/action/retry',\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => '',\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 0,\n  CURLOPT_FOLLOWLOCATION => true,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => 'POST',\n  CURLOPT_POSTFIELDS =>'{\n    \"date\": {\n        \"day\": 28,\n        \"month\": 5,\n        \"year\": 2021\n    }\n}',\n  CURLOPT_HTTPHEADER => array(\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',\n    'Content-Type: application/json'\n  ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;",
        "language": "php"
      }
    ],
    "selectedLanguageId": "9a-T_XqXj1iZKIVi3kA9A"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "autoGeneratedAnchorSlug": "reintentar-una-ejecucin",
  "legacyHash": "V1m3fA9TozXkHWk_ITOxp"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://api.unicobros.com.ar/p/subscriptions/{id}/subscriber/{sid}/execution/{eid}/action/paid",
  "name": "Marcar una ejecución como Paga",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "ID de la suscripción."
      },
      {
        "kind": "required",
        "name": "sid",
        "type": "string",
        "description": "ID del suscriptor."
      },
      {
        "kind": "required",
        "name": "eid",
        "type": "string",
        "description": "ID de la ejecución a marcar como paga."
      }
    ],
    "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": "pNmgZ1x4GoDISV5d9DoMF",
        "code": "{\n    \"result\": true\n}",
        "language": "200"
      },
      {
        "id": "4g6g6YOsYt9oz__b_jNMl",
        "code": "{\n    \"message\": \"Ain't no cake like that.\"\n}",
        "language": "404"
      }
    ],
    "selectedLanguageId": "pNmgZ1x4GoDISV5d9DoMF"
  },
  "examples": {
    "languages": [
      {
        "id": "hMLcrLcl6G1rBbaJei52T",
        "code": "fetch(\"https://api.cakes.com\", {\n  \"method\": \"GET\",\n  \"headers\": {\n    \"Accept\": \"application/json\"\n  }\n})\n.then(response => {\n  console.log(response);\n})\n.catch(err => {\n  console.error(err);\n});",
        "language": "javascript"
      }
    ],
    "selectedLanguageId": "hMLcrLcl6G1rBbaJei52T"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Query Parameter",
    "value": "queryParameters"
  },
  "autoGeneratedAnchorSlug": "marcar-una-ejecucin-como-paga",
  "legacyHash": "DaXeaRWaebkBjxylKqh_3"
}
```
:::

# WebHooks

Los webhooks siempre serán enviados en formato `application/x-www-form-urlencoded`

### Nueva Suscripción

```json
{
    "type": "subscription:registration",
    "data": {
        "result": true,
        "view": {
            "type": "card"
        },
        "payment": {
            "id": "ABABBB78798",
            "description": "Esto es un registro!",
            "operation": {
                "type": "validation"
            },
            "status": {
                "code": "200",
                "text": "Aprobado",
                "message": "Transacción Aprobada"
            },
            "total": 14.3,
            "currency": {
                "code": "ARS",
                "text": "Peso Argentino",
                "symbol": "$"
            },
            "riskAnalysis": {
                "band": "N/A",
                "level": "N/A"
            },
            "created": "2020-12-02T18:12:11.122Z",
            "updated": "2020-12-02T18:12:12.768Z",
            "reference": "extenal_reference",
            "source": {
                "name": "Visa Débito",
                "type": "card",
                "reference": "visa.debit",
                "number": "4515 00** **** 1234",
                "expiration": {
                    "month": "01",
                    "year": "26"
                },
                "installment": {
                    "description": "Débito",
                    "amount": 14.3,
                    "count": 1,
                    "reference": "1"
                }
            }
        },
        "entity": {
            "name": "Demo Entity",
            "uid": "demo_entity"
        },
        "customer": {
            "uid": "12123123",
            "name": "Juan Perez Wayne",
            "phone": "12123123",
            "identification": "110303456",
            "email": "soybatman@wayneinc.com"
        },
        "user": {
            "name": "Juan Perez Wayne",
            "email": "juan.perez@mimail.com"
        },
        "source": {
            "name": "Visa Débito",
            "type": "card",
            "reference": "visa.debit"
        },
        "subscription": {
            "uid": "DRXR14KIUC4V8TFBRL",
            "interval": "1m",
            "limit": 4,
            "name": "El nombre de mi suscripción",
            "description": "Esto es GENIAL",
            "reference": "external_reference",
            "total": 1595
        },
        "subscriber": {
            "uid": "RLY80US2JZ8ZHTSCPH",
            "reference": "3447",
            "customer": {
                "identification": "12123123",
                "email": "juan.perez@mimail.com",
                "name": "Juan Perez Wayne"
            }
        },
        "context": {
            "status": "success"
           },
        "execution": {}
    }
}
```

### Cambio de Método de Pago

```json
{
    "type": "subscription:change_source",
    "data": {
            "result": true,
            "view": {
                "type": "card"
            },
            "payment": {
                "id": "ABC123123",
                "description": "Validación de Tarjeta.",
                "operation": {
                    "type": "validation"
                },
                "status": {
                    "code": "410",
                    "text": "Denegada, Fondos insuficientes",
                    "message": "Denegada, fondos insuficientes. (Cod. 51)"
                },
                "total": 17.15,
                "currency": {
                    "code": "ARS",
                    "text": "Peso Argentino",
                    "symbol": "$"
                },
                "riskAnalysis": {
                    "band": "N/A",
                    "level": "N/A"
                },
                "created": "2020-12-02T11:31:56.544Z",
                "updated": "2020-12-02T11:31:58.243Z",
                "reference": "external_reference",
                "source": {
                    "name": "Visa",
                    "type": "card",
                    "reference": "visa",
                    "number": "4515 00** **** 1234",
                    "expiration": {
                        "month": "01",
                        "year": "24"
                    },
                    "installment": {
                        "description": "1 Cuota",
                        "amount": 17.15,
                        "count": 1,
                        "reference": "1"
                    }
                }
            },
            "entity": {
                "name": "Demo Entity",
                "uid": "demo_entity"
            },
            "customer": {
                "uid": "12123123",
                "name": "Juan Perez Wayne",
                "phone": "12123123",
                "identification": "110303456",
                "email": "soybatman@wayneinc.com"
            },
            "user": {
                "name": "Juan Perez Wayne",
                "email": "juan.perez@mimail.com"
            },
            "source": {
                "name": "Visa",
                "type": "card",
                "reference": "visa"
            },
            "subscription": {
                "uid": "4546465465465",
                "interval": "1m",
                "limit": 0,
                "name": "Mi Suscripción",
                "description": "Débitos automáticos? Todavía existe eso?",
                "reference": "external_reference",
                "total": 8000.14
            },
            "subscriber": {
                "uid": "Fvon4enAv5",
                "reference": "5defe0af-e9be-4288-bed1-423a5cc41920",
                "customer": {
                    "email": "juan.perez@mimail.com",
                    "name": "Juan Perez Wayne",
                    "identification": "12123123",
                    "phone": "1112341234"
                }
            },
            "context": {
                "status": "success"
               },
            "execution": {}
        }
    }
}
```

### Suscripción Ejecutada

El servicio para este Webhook utiliza los webhooks estandares descriptos en la sección Webhooks de esta documentación agregando los nodos "subscription" y "subscriber"

```json
{
    "type": "subscription:execution",
    "data": {
        "result": true,
        "view": {
            "type": "card"
        },
        "payment": {
            "id": "ABC121232",
            "description": "Cobro Ejecutado",
            "operation": {
                "type": "payment.v2"
            },
            "status": {
                "code": "410",
                "text": "Denegada, Fondos insuficientes",
                "message": "Denegada, fondos insuficientes. (Cod. 51)"
            },
            "total": 1533.11,
            "currency": {
                "code": "ARS",
                "text": "Peso Argentino",
                "symbol": "$"
            },
            "riskAnalysis": {
                "band": "N/A",
                "level": "N/A"
            },
            "created": "2020-12-02T01:00:55.994Z",
            "updated": "2020-12-02T01:00:57.091Z",
            "reference": "external_reference",
            "source": {
                "name": "Visa Débito",
                "type": "card",
                "reference": "visa.debit",
                "number": "4515 00** **** 1234",
                "expiration": {
                    "month": "02",
                    "year": "26"
                },
                "installment": {
                    "description": "Débito",
                    "amount": 1546.55,
                    "count": 1,
                    "reference": "1"
                }
            }
        },
        "entity": {
                "name": "Demo Entity",
                "uid": "demo_entity"
        },
        "customer": {
            "uid": "12123123",
            "name": "Juan Perez Wayne",
            "phone": "12123123",
            "identification": "110303456",
            "email": "soybatman@wayneinc.com"
        },
        "user": {
            "name": "Juan Perez Wayne",
            "email": "juan.perez@mimail.com"
        },
        "source": {
            "name": "Visa Débito",
            "type": "card",
            "reference": "visa.debit"
        },
        "subscription": {
            "uid": "fdSxU7RbC",
            "interval": "1m",
            "limit": 5,
            "name": "Mi Suscripción",
            "description": "Dinosaurios",
            "reference": "external_reference",
            "total": 1547
        },
        "subscriber": {
            "uid": "CBA456456",
            "reference": "exernal_reference",
            "period": -1,
            "customer": {
                "identification": "123123132",
                "email": "juan.perez@mimail.com",
                "name": "Juan Perez Wayne"
            }
        },
        "context": {
            "status": "success"
           },
        "execution": {
            "uid": "54Z45DRXEZ01QWYLUL"
        }
    }
}
```

### Suscriptor Suspendido

```json
{
    "type": "subscription:subscriber:suspended",
    "data": {
        "subscription": {
            "uid": "JmfI3Ml3D",
            "interval": "1m",
            "limit": 0,
            "name": "Nombre de la Suscripción",
            "description": "Descripción de la Suscripción",
            "total": 500
        },
        "subscriber": {
            "uid": "qy82noStM",
            "reference": "qy82noStM",
            "customer": {
                "name": "Juan Batman",
                "identification": "999999",
                "email": "soybatman@gmail.com"
            }
        }
    }
}
```

### Suscriptor Activado

```javascript
{
    "type": "subscription:subscriber:active",
    "data": {
        "subscription": {
            "uid": "JmfI3Ml3D",
            "interval": "1m",
            "limit": 0,
            "name": "Nombre de la Suscripción",
            "description": "Descripción de la Suscripción",
            "total": 500
        },
        "subscriber": {
            "uid": "qy82noStM",
            "reference": "qy82noStM",
            "customer": {
                "name": "Juan Batman",
                "identification": "999999",
                "email": "soybatman@gmail.com"
            }
        }
    }
}
```

# Redirección

Cuando el servicio redirige al suscriptor a la `return_url` definida al crear la suscripción, se agregan un conjunto de parámetros en la url para indicarle al sitio el resultado de la suscripción.

Los parámetros de tipo query que se agregan a la url definida son:

- `reference`: referencia asignada al suscriptor.
- `status`: estado de la transacción asociada a la operación de suscripción.
- `uid`: ID de la suscripción.
- `sid`: ID del suscriptor.

Cuando se cancela el proceso de suscripción, el status será 0.