Pagos
Payments

Este endpoint se utiliza para devolver un importe a la tarjeta con la que se hizo el pago. Si no se envía el campo amount, la devolución será total. Si se envía este campo, la devolución será del importe enviado (siempre y cuando sea válido).

Cuando la devolución se haga a través de un marketplace. Se debe incluir el campo extra_data, indicando dentro marketplace_refundsy los datos pertinentes a cada comercio y el importe devuelto por cada uno.

En el campo amount, del comercio que efectúa la devolución, será igual al amount indicado fuera del extra_data y en el net_amount se indicará el importe que devolverá cada una de las partes involucradas en la devolución.

Si un intento de devolución falla, se deberá esperar 1 minuto desde el último intento fallido antes de realizar un nuevo intento. En caso de que una devolución sea exitosa, no será necesario esperar para realizar otro intento de devolución. Sin embargo, si el sistema detecta 3 intentos fallidos en total, no se permitirán más intentos hasta el inicio del próximo día.

A partir del tercer intento fallido, solo se permitirá un devolución fallida al día. Esto significa que después de los tres primeros reintentos fallidos, si el siguiente también falla, deberá esperar hasta el siguiente día para realizar otro intento.

post/payment/refund

Request

  • Base URL
    https://api.paylands.com/v1/sandbox
  • URL
    https://api.paylands.com/v1/sandbox/payment/refund
  • Auth
    none required

Parameters

#/paths/~1/get/parameters/0 (unresolved $ref)

Request body

signatureSignature required(unresolved $ref)
order_uuidUuid required(unresolved $ref)
amountnumber nullable

Cantidad a devolver, en la moneda fraccionaria elegida. Una cantidad de 100 utilizando la moneda Euro es igual a 1€.

Example request

{
  "signature": "121149a0ba5361191d740fa898784a8b",
  "order_uuid": "1f405ea3-9798-42a6-9e87-bd347ef67f55",
  "amount": 100,
  "extra_data": {
    "marketplace_refunds": [
      {
        "merchant_location_id": 2,
        "amount": 0,
        "description": "Marketplace",
        "net_amount": 10
      },
      {
        "merchant_location_id": 4487,
        "amount": 100,
        "description": "Commerce",
        "net_amount": 90
      }
    ]
  }
}

Response

OK

messagestring required

Nombre del código HTTP de respuesta.

codenumber required

Código de respuesta.

current_timestring required

Fecha y hora de la petición.

Changes

    • warning

      added the new jp enum value to the //// response property for the response status

    • info

      removed the ja enum value from the //// response property for the response status

    • warning

      added the new ja enum value to the //// response property for the response status

    • info

      removed the jp enum value from the //// response property for the response status