Reembolsos

Reembolsa un pago.

Rapyd proporciona un método rápido y sencillo para procesar los reembolsos de una compra realizada por un cliente en su sitio web. Los reembolsos se realizan al método de pago utilizado en la transacción de pago original

Certificación PCI

Solo clientes con certificación PCI-DSS pueden gestionar la información de identificación personal de las tarjetas. Este método está disponible para los comercios que hayan firmado un acuerdo especial con Rapyd

Un cliente compra un artículo en su sitio web por USD 10.99 (dólares estadounidenses) con su tarjeta. Ahora el cliente quiere devolver el artículo para obtener un reembolso. En este caso de uso, el cliente pagó con tarjeta, por lo que el reembolso se devuelve a esa tarjeta.

El back-end de su sitio web le pide a Rapyd que procese el reembolso. Cuando el dinero se devuelve a la tarjeta, Rapyd le notifica que el reembolso se realizó correctamente.

Reembolso de un flujo de trabajo de pago

Puede encontrar los métodos de pago por transferencia bancaria específicos que aceptará y los campos obligatorios correspondientes que los clientes deben rellenar en la sección Cómo funciona.

El cliente ha pagó previamente artículo. Ahora el cliente rellena todos los campos requeridos en su sitio web en la página Solicitud de reembolso. Tiene el ID de la transacción y el monto que debe reembolsarse.

El back-end del sitio web solicita a Rapyd que procese el reembolso del cliente.
Rapyd procesa la transacción de reembolso y le notifica que se ha realizado correctamente.
Envía la confirmación del reembolso al cliente.

Secuencias de mensajes de reembolso

Los siguientes diagramas de secuencia de mensajes describen cómo se intercambia la información entre Rapyd, el comercio y el emisor de la tarjeta.

Reembolso: exitoso

Reembolso: rechazado

Estados de reembolso

El siguiente diagrama de estados finitos resume los estados de los pagos reembolsados.

Descripción de los estados

Estado	Descripción
Pendiente	El reembolso aún no se ha completado. Por ejemplo, es posible que el reembolso aún requiera una acción del cliente, como retirar el reembolso en efectivo
Completado	Se completó el reembolso.
Rechazado	El reembolso no se realizó debido a un error interno.
Error	El reembolso ha fallado.

Cómo funcionan los reembolsos

Crear el reembolso

Prerrequisitos

Para ejecutar los ejemplos de este caso de uso, debe crear el siguiente ID en su propio sandbox:

'payment' - Ejecutar Crear pago. Use el «ID» que obtiene en la respuesta.

Cuando el cliente solicite un reembolso en su sitio web, le solicita a Rapyd que procese el reembolso.

Para eso, utilizará Crear reembolso con el siguiente parámetro:

Descripción de los parámetros del cuerpo

Parámetro del cuerpo	Descripción
payment	Introduzca el «ID» del pago que recibió cuando creó el pago en su sandbox. Para esta lección de caso de uso, estamos usando payment_1b3e27edf2c43a0b5d1a7de69fbe7102, que es el ID de pago que hemos creado en nuestro sandbox.

No necesita especificar el monto, ya que se trata de un reembolso completo.

Crear solicitud de reembolso

Le solicita a Rapyd que procese el reembolso de la transacción anterior.

Solicitud

// Request URL: POST https://sandboxapi.rapyd.net/v1/refunds

// Message body:
{
  "payment": "payment_29816514741fe7e4cdee75f7093ccbe1"
}

.NET Core

using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                var requestObj = new
                {
                    payment = "payment_29816514741fe7e4cdee75f7093ccbe1",
                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/refunds", request);

                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('../../../../../Utilities/JS/utilities').makeRequest;

async function main() {
  try {
    const body = {
      payment: 'payment_29816514741fe7e4cdee75f7093ccbe1'
    };
    const result = await makeRequest('POST', '/v1/refunds', body);

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/code_race_2020/Utilities/PHP/utilities.php";
include($path);

$body = [
    "payment" => "payment_29816514741fe7e4cdee75f7093ccbe1"
];

try {
    $object = make_request('post', '/v1/refunds', $body);
    var_dump($object);
} catch (Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

refund_body = {
    "payment": "payment_29816514741fe7e4cdee75f7093ccbe1"
}

create_refund_results = make_request(method='post',
                                     path='/v1/refunds',
                                     body=refund_body)

pprint(create_refund_results)

Obtenga una respuesta de reembolso

Veamos la respuesta.

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "bc321df9-7bb4-47ce-907a-7bbc5a9b32f7"
    },
    "data": {
        "id": "refund_dcdacdb591a117d3d5eb30e59011aadd",
        "amount": 15.65,
        "payment": "payment_29816514741fe7e4cdee75f7093ccbe1",
        "currency": "USD",
        "failure_reason": "",
        "metadata": {},
        "reason": "",
        "status": "Completed",
        "receipt_number": 0,
        "created_at": 1589302965,
        "updated_at": 1589302965,
        "merchant_reference_id": "",
        "payment_created_at": 1589237080,
        "payment_method_type": "us_debit_visa_card",
        "ewallets": [
            {
                "ewallet": "ewallet_be4ba8f13da40caa59a7e03022a8acfe",
                "amount": 15.65
            }
        ],
        "proportional_refund": true
    }
}

La sección data de esta respuesta muestra:

El amount es 15,65.
El currency es USD.
El status es Completado.

Nota

Si el pago se realizó en efectivo o mediante un redireccionamiento bancario, completar el proceso de reembolso requiere los mismos pasos adicionales que el método de pago original. Para simular la acción del cliente, ejecute Reembolso completo.

Rapyd envía un webhook para notificarle que la transacción de reembolso se ha completado.

Una vez realizados todos los pasos adicionales, su sitio web muestra al cliente una confirmación de que el reembolso se ha completado.

Visualizar detalles de transacciones

Para ver los detalles del pago y el reembolso, use Recuperar el pago.

¿Busca información técnica más detallada?

¿Desea ver los métodos y objetos de la API de Rapyd que utilizará? Ver Merchant API Reference para obtener más detalles técnicos.

En esta sección:

Documentación