Pago con tarjeta

Envía fondos a una tarjeta con Rapyd Disburse. | Empresa

Rapyd facilita el desembolso a una tarjeta. Los casos de uso comunes incluyen

Pago a la tarjeta de un empleado o trabajador
Pago a una tarjeta para el uso del crédito o los beneficios

Certificación PCI

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

Su plataforma de mejoras para el hogar conecta a los clientes con profesionales de servicios a domicilio, como plomeros, electricistas y cerrajeros. Usted recauda a los clientes y desembolsa los fondos a los profesionales

Su sistema de cuentas automatizadas realiza los desembolsos desde el monedero de la empresa. Se crea un monedero tal y como se describe en Creación de una billetera Rapyd.

Uno de los cerrajeros termina un trabajo y su sistema de cuentas transfiere un pago de 250 USD (dólares estadounidenses) a su tarjeta.

Flujo de trabajo de pago con tarjeta

Puedes encontrar los métodos de pago con tarjeta específicos que utilizarás y los campos obligatorios correspondientes que deben rellenar los beneficiarios en ¿Cómo funciona.

Tu sistema de cuentas le pide a Rapyd que procese el pago.
Rapyd procesa el pago.
El back-end del sitio web recibe la confirmación de Rapyd de que se completó el pago.

Secuencias de mensajes de pago con tarjeta

Los siguientes diagramas de secuencia de mensajes describen cómo se intercambia la información entre Rapyd, el comerciante y la red de tarjetas.

Crear pago con tarjeta: beneficiario guardado

Crear pago con tarjeta: nuevo beneficiario

Cómo funciona el pago a una tarjeta

Prerrequisitos

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

monedero electrónico - Corre Crea una billetera para la billetera electrónica de la plataforma Home Improvement. Usa el identificador que aparece en la respuesta

Búsqueda de tipos de métodos de pago

Encuentra los tipos de métodos de pago que puedes usar. Consulte Enumere los tipos de métodos de pago.

Búsqueda de campos obligatorios para el tipo de método de pago

Busca los campos obligatorios para cada tipo de método de pago. Consulta Obtenga los campos obligatorios de pago.

Sugerencia

En el Obtenga los campos obligatorios de pago respuesta, campos_requeridos_beneficiarios define los campos obligatorios para un beneficiario objeto. Validar beneficiario para comprobar los campos del beneficiario antes de solicitar un pago. Consulte Validación de los detalles del beneficiario.

Solicitar un pago

Su negocio de mejoras para el hogar es el remitente de pagos y el cerrajero es el beneficiario quién recibe los fondos.

Para desembolsar los fondos a la tarjeta del cerrajero, le pides a Rapyd que procese el pago.

Para eso, utilizarás Crea Payout con los siguientes parámetros:

Descripción de los parámetros

Parámetro corporal	Descripción
monedero electrónico	Introduce el «identificador» de la cartera que recibiste cuando creaste la cartera de la empresa en tu entorno de pruebas. Para los fines de esta lección de casos de uso, estamos usando ewallet_e22fe4e337e26734a96d13a241063a75, que es el identificador de monedero que hemos creado en nuestra zona de pruebas.
importa_desembolso	Entrar 250 como la cantidad recibida por el beneficiario.
tipo_de_método de pago	Entrar us_debit_visa_card como tipo de método de pago.
divisa del remitente	Entrar USD como código para dólares estadounidenses, la moneda del remitente.
país del remitente	Entrar NOSOTROS como código para los Estados Unidos, el país del remitente.
país_beneficiario	Entrar NOSOTROS como código para los Estados Unidos, el país del beneficiario.
divisa_de_pago	Entrar USD como código para dólares estadounidenses, la moneda recibida por el beneficiario.
tipo_de_entidad_remitente	Entrar empresa como el tipo de entidad para el remitente.
tipo_de_entidad_beneficiaria	Entrar individual como el tipo de entidad para el beneficiario.
beneficiario	Introduzca un `beneficiario` objeto que contiene los campos obligatorios que figuran en la respuesta a «Los campos obligatorios para obtener el pago». Para este ejemplo, introduce `correo electrónico` - testemployee@rapyd.net `número_tarjeta` - 4 1111111 `mes_caducidad_tarjeta` - 10 `año_caducidad_tarjeta` - 20 `nombre_de_pila` - Prueba `apellido_nombre` - Empleado
descripción	Entrar Pago a tarjeta como la descripción de la transacción de pago.

Crear solicitud de pago

Le pides a Rapyd que procese el pago de 250 USD (dólares estadounidenses) a la tarjeta del cerrajero.

Solicitud

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

// Message body:
{
    "ewallet": "ewallet_e22fe4e337e26734a96d13a241063a75",
    "payout_amount": 250,
    "payout_method_type": "us_debit_visa_card",
    "sender_currency": "USD",
    "sender_country": "US",
    "beneficiary_country": "US",
    "payout_currency": "USD",
    "sender_entity_type": "company",
    "beneficiary_entity_type": "individual",
    "beneficiary": {
        "email": "testemployee@rapyd.net",
        "card_number": "4111111111111111",
        "card_expiration_month": "10",
        "card_expiration_year": "20",
        "first_name": "Test",
        "last_name": "Employee"
    },    
    "description": "Payout to card"
}

.NET Core

using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {

                var requestObj = new
                {
                    ewallet = "ewallet_e22fe4e337e26734a96d13a241063a75",
                    payout_amount = 250,
                    payout_method_type = "us_visa_card",
                    sender_currency = "USD",
                    sender_country = "US",
                    beneficiary_country = "US",
                    payout_currency = "USD",
                    sender_entity_type = "company",
                    beneficiary_entity_type = "individual",
                    beneficiary = new
                    {
                        email = "johndoe@rapyd.net",
                        card_number = "4111111111111111",
                        card_expiration_month = "10",
                        card_expiration_year = "20",
                        first_name = "John",
                        last_name = "Doe"
                    },
                    description = "Payout to card"

                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/payouts", 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 = {
      ewallet: 'ewallet_e22fe4e337e26734a96d13a241063a75',
      payout_amount: 250,
      payout_method_type: 'us_visa_card',
      sender_currency: 'USD',
      sender_country: 'US',
      beneficiary_country: 'US',
      payout_currency: 'USD',
      sender_entity_type: 'company',
      beneficiary_entity_type: 'individual',
      beneficiary: {
        email: 'johndoe@rapyd.net',
        card_number: '4111111111111111',
        card_expiration_month: '10',
        card_expiration_year: '20',
        first_name: 'John',
        last_name: 'Doe'
      },
      description: 'Payout to card'
    };
    const result = await makeRequest('POST', '/v1/payouts', 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 = [
    'ewallet' => "ewallet_e22fe4e337e26734a96d13a241063a75",
    "payout_amount" => 250,
    "payout_method_type" => "us_visa_card",
    "sender_currency" => "USD",
    "sender_country" => "US",
    "beneficiary_country" => "US",
    "payout_currency" => "USD",
    "sender_entity_type" => "company",
    "beneficiary_entity_type" => "individual",
    "beneficiary" => array(
        "email" => "johndoe@rapyd.net",
        "card_number" => "4111111111111111",
        "card_expiration_month" => "10",
        "card_expiration_year" => "20",
        "first_name" => "John",
        "last_name" => "Doe"
    ),
    "description" => "Payout to card"
];

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

Pitón

from pprint import pprint

from utilities import make_request

payout_body = {
    "ewallet": "ewallet_e22fe4e337e26734a96d13a241063a75",
    "payout_amount": 250,
    "payout_method_type": "us_visa_card",
    "sender_currency": "USD",
    "sender_country": "US",
    "beneficiary_country": "US",
    "payout_currency": "USD",
    "sender_entity_type": "company",
    "beneficiary_entity_type": "individual",
    "beneficiary": {
        "email": "johndoe@rapyd.net",
        "card_number": "4111111111111111",
        "card_expiration_month": "10",
        "card_expiration_year": "20",
        "first_name": "John",
        "last_name": "Doe"
    },
    "description": "Payout to card"
}
result = make_request(method='post', path='/v1/payouts', body=payout_body)
pprint(result)

Crear respuesta de pago

Echemos un vistazo a la respuesta.

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "abccbd6f-ddc2-4884-887c-aefa94526a7c"
    },
    "data": {
        "id": "payout_9600f264f394314fd178ba9eae689005",
        "payout_type": "card",
        "payout_method_type": "us_debit_visa_card",
        "amount": 250,
        "payout_currency": "USD",
        "sender_amount": 250,
        "sender_currency": "USD",
        "status": "Completed",
        "sender_country": "US",
        "sender": {
            "id": "sender_afb24391ce4649619c4e9830abfa2f11",
            "country": "US",
            "entity_type": "company",
            "currency": "USD"
        },
        "beneficiary_country": "US",
        "beneficiary": {
            "id": "beneficiary_022ce7183dcc8eb93ffa80933a50ecd3",
            "last_name": "Employee",
            "first_name": "Test",
            "country": "US",
            "entity_type": "individual",
            "name": "Test Employee",
            "currency": "USD",
            "email": "testemployee@rapyd.net",
            "card_expiration_year": "20",
            "card_expiration_month": "10",
            "card_number": "1111"
        },
      
//      ...      
      
        "ewallets": [
            {
                "ewallet_id": "ewallet_e22fe4e337e26734a96d13a241063a75",
                "amount": 250,
                "percent": 100 
            }
        ],
      
//      ...      
      
        "description": "Payout to card",
        "created_at": 1580029824,
      
//      ...      
      
    }
}

Además de los valores de los parámetros que ha introducido en la solicitud, el datos la sección de esta respuesta muestra:

El payout_type es tarjeta.
El pago cantidad es 250.
El payout_currency es USD.
El estado es Completado. Esto significa que el cerrajero recibió los fondos de pago

En esta sección:

Documentación