Devoluciones

2 min

Anulación / Devolución Total

Mediante este llamado a nuestro API podrás procesar la devolución total o anulación de una compra en estado Pago. Es importante aclarar que los medios de pago Binance, Pix, QR interoprable, Debin y pago en efectivo no soportan anulación o devolución del monto abonado.

GET

https://api.mobbex.com/p/operations/{ID}/refund

Query Parameters

IDstringrequired
Description
ID de la Operación que se intenta devolver.

Header Parameters

x-api-keystringrequired
Description
Clave API de su aplicación.
x-access-tokenstringrequired
Description
Token de acceso a la entidad.

curl

curl --request GET \
  --url https://api.mobbex.com/p/operations/NfkvurRUX/refund \
  --header 'cache-control: no-cache' \
  --header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
  --header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'

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/operations/NfkvurRUX/refund");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send();

php

<?php
$request = new HttpRequest();
$request->setUrl('https://api.mobbex.com/p/operations/NfkvurRUX/refund');
$request->setMethod(HTTP_METH_GET);
$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'content-type' => 'application/json',
  'x-access-token' => 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc',
  'x-api-key' => 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj'
));
try {
  $response = $request->send();
  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
?>

200

{
    "result": true,
    "status_message": "Aprobado"
}

Si la anulación/devolución total se realiza en el día el webhook devolverá 601 (Cancelado). En el caso de que se realice al otro día 602 (Devuelto).

Devolución Total con Opciones o Parcial

Mediante este llamado a nuestro API podrás procesar la devolución parcial de una compra en estado Pago. Es importante aclarar que no todos los medios de pago soportan anulación o devolución del monto abonado.

POST

https://api.mobbex.com/p/operations/{ID}/refund

Query Parameters

IDstringrequired
Description
ID de la Operación que se intenta devolver.

Header Parameters

x-api-keystringrequired
Description
Clave API de su aplicación.
x-access-tokenstringrequired
Description
Token de Acceso

Body Parameters

totalNumber
Description
Monto que se devolverá. Si no se envía se devolverá el total de la operación. Formato XXX.xx donde el PUNTO es el separador decimal.
terminalstring
Description
Sólo para Transacciones con POS ( Tarjeta Presente ). Permite hacer una devolución en un POS diferente al usado en la transacción original. Si no se envía se utilizará el POS original. Si se envía null o false y es el POS es requerido devolverá error "POS:POS_ACTION_REQUIRED". Si no se envía terminal o se envía una se devolverá como error "POS:POS_ACTION_SENT_TO_POS" notando que la acción fue enviada al POS para finalizarla.

javascript

var data = JSON.stringify({
  "total": 100
});

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/operations/91MIUU1eM/refund");
xhr.setRequestHeader("x-api-key", "zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj");
xhr.setRequestHeader("x-access-token", "d31f0721-2f85-44e7-bcc6-15e19d1a53cc");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

php

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.mobbex.com/p/operations/91MIUU1eM/refund',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "total": 100
}',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',
    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

200

{
    "result": true,
    "status_message": "Aprobado"
}

Si la devolución parcial se trata de realizar en el mismo día, dará error. Únicamente se puede realizar al otro día y el webhook será codigo 200, ya que se sigue encontrando parcialmente aprobada.