Tarjeta archivada

Almacene la información de pago de los clientes para compras recurrentes y de suscripción.

Agilice el proceso de archivado de la tarjeta y reduzca su PCI El cumplimiento es una carga al generar un token seguro para los clientes que opten por guardar su información de pago en su empresa.

Un caso de uso típico puede seguir estos pasos:

Mientras está en tu sitio web, tu cliente elige guardar su tarjeta para usarla en el futuro.
Rapyd almacena los detalles de la tarjeta y la vincula al identificador personal único Rapyd de su cliente.
Tu cliente compra un artículo por 9,99 USD (dólares estadounidenses) con la tarjeta guardada.
Un mes después, vuelven a comprar otro artículo por 9,99 USD (dólares estadounidenses).
Tu sitio web muestra la tarjeta almacenada como método de pago seleccionado.
Tu cliente solo hace clic para pagar.

Múltiples métodos de pago

El caso de uso se refiere a un cliente que almacena un único método de pago en Rapyd. Sin embargo, los clientes pueden almacenar varios métodos de pago si así lo desean

Pago con tarjeta archivada

Selecciona la tarjeta que quieres usar para el pago.
Haga clic en lápiz icono para editar los detalles de la tarjeta.
Opcional: puedes actualizar los detalles de la tarjeta. Haz clic Actualizar para guardar los cambios.
Haga clic Haga su pedido.
Redirigir a la Pago exitoso página.
Haga clic Finalizar.

Flujo de trabajo de tarjeta en archivo

Puedes encontrar los métodos de pago con tarjeta específicos que aceptarás y los campos obligatorios correspondientes que los clientes deben rellenar en la sección Cómo funciona.

Paso 1: Guardar una tarjeta de cliente

Un cliente de tu sitio web añade un artículo al carrito de compras y pulsa el botón de pago. El cliente rellena la información de la tarjeta y selecciona Guarde los detalles de la tarjeta para usarlos en el futuro. Luego, el cliente hace clic ¡Pague ahora.
Tu sitio web le pide a Rapyd que cree un identificador de cliente.
Luego, su sitio web le pide a Rapyd que cree un bono de 0$ Auth pago para validar la tarjeta utilizando el identificador de cliente.
Rapyd envía a tu sitio web el identificador de cliente para usar la tarjeta registrada como método de pago predeterminado del cliente.

Nota

Para obtener más información sobre cómo guardar la información de la tarjeta del cliente mediante una página alojada, consulte Guarde los detalles de la tarjeta con Rapyd Checkout.

Paso 2: Procesar el pago por primera vez

El back-end del sitio web le pide a Rapyd que procese el pago del cliente, especificando el monto, la moneda y la identificación del cliente.
Rapyd procesa la transacción con la tarjeta almacenada que está vinculada al ID del cliente. Cuando se completa correctamente, Rapyd lo notifica al back-end del sitio web
Tu sitio web muestra una página que informa al cliente de que la compra se ha completado correctamente.

Paso 3: Iniciar una compra posterior

Su cliente regresa un mes después, agrega un nuevo libro electrónico al carrito de compras y finaliza el proceso de compra.
Según la información intercambiada con Rapyd, tu sitio web muestra la tarjeta almacenada como el método de pago seleccionado.
El cliente hace clic ¡Pague ahora .

Paso 4: Procesar un pago posterior

El back-end del sitio web le pide a Rapyd que procese el pago del cliente, especificando el monto, la moneda y la identificación del cliente.
Rapyd procesa la transacción con la tarjeta almacenada que está vinculada al ID del cliente. Cuando se completa correctamente, Rapyd notifica al back-end del sitio web
Su sitio web muestra una página de «compra realizada correctamente» para su cliente.

Cómo funciona Card on File

Encuentra los métodos de pago disponibles

Decide qué métodos de pago con tarjeta aceptarás para que tu cliente pueda especificar sus métodos de pago en tu página de pago. Listar los métodos de pago por país con los siguientes parámetros:

EE. UU. y USD se muestran como ejemplo de país y moneda.

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
país	Entrar NOSOTROS como código de país.
moneda	Entrar USD como código de divisa.

Solicitud de lista de métodos de pago por país

Crea una solicitud para obtener una lista de todos los métodos de pago disponibles en EE. UU.

Solicitud

// Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/country?country=US&currency=USD

// Message body absent

.NET Core

using System;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string country = "US";
                string currency = "USD";

                string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/payment_methods/country?country={country}&currency={currency}");

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

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const result = await makeRequest('GET', '/v1/payment_methods/country?country=US&currency=USD');

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

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

try {
    $object = make_request('get', '/v1/payment_methods/country?country=US&currency=USD');
    var_dump($object);
} catch (Exception $e) {
    echo "Error: $e";
}
?>

Pitón

from pprint import pprint

from utilities import make_request

country = 'US'
currency = 'USD'
results = make_request(method='get',
                       path=f'/v1/payment_methods/country?country={country}&currency={currency}')
pprint(results)

Lista de métodos de pago por país Respuesta

Tipo de método de pago describe los campos de la respuesta.

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "cfa35a73-aa0b-4e7e-839c-4c3b6149edd7"
    },
    "data": [{
            "type": "us_debit_visa_card",
            "name": "Visa",
            "category": "card",
            "image": "https://iconslib.rapyd.net/checkout/us_visa_card.png",
            "country": "us",
            "payment_flow_type": "card",
            "currencies": [
                "USD"
            ],
            "status": 1,
            "is_cancelable": false,
            "payment_options": [{
                    "name": "customer",
                    "type": "customer",
                    "regex": "",
                    "description": "make sure a customer was created with first_name, last_name and email",
                    "is_required": true,
                    "is_updatable": false
                }
            ],
            "is_expirable": false,
            "is_online": false,
            "minimum_expiration_seconds": null,
            "maximum_expiration_seconds": null
        }
    ]
}

El datos La sección de la respuesta muestra que una tarjeta Visa es una opción de pago aceptable.

Nota

Una respuesta real suele incluir muchos métodos de pago.

Busque los campos obligatorios para el método de pago

Debes identificar los campos que el cliente debe completar para el método de pago.

Para identificar los campos, utilizarás el Campos obligatorios para obtener el método de pago con el siguiente parámetro.

Descripción de los parámetros de ruta

Parámetro de ruta	Descripción
tipo	Entrar us_debit_visa_card como tipo de método de pago.

Obtener el método de pago Campos obligatorios Solicitud

Crea una solicitud para el conjunto de campos obligatorios para una tarjeta Visa.

Solicitud

// Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/us_debit_visa_card/required_fields

// Message body absent

.NET Core

using System;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string type = "us_visa_card";

                string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/payment_methods/{type}/required_fields");

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

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const result = await makeRequest('GET', '/v1/payment_methods/us_visa_card/required_fields');

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

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

try {
    $object = make_request('get', '/v1/payment_methods/us_visa_card/required_fields');
    var_dump($object);
} catch (Exception $e) {
    echo "Error: $e";
}
?>

Pitón

from pprint import pprint

from utilities import make_request

payment_method = 'us_visa_card'
results = make_request(method='get',
                       path=f'/v1/payment_methods/{payment_method}/required_fields')
pprint(results)rom pprint import pprint

from utilities import make_request

country = 'US'
currency = 'USD'
results = make_request(method='get',
                       path=f'/v1/payment_methods/country?country={country}&currency={currency}')
pprint(results)

Obtener el método de pago Campos obligatorios Respuesta

Tipo de método de pago describe los campos de la respuesta.

Respuesta

{
    “status”: {
        “error_code”: “”,
        “status”: “SUCCESS”,
        “message”: “”,
        “response_code”: “”,
        “operation_id”: “598b1a00-e302-4037-b0ef-aac895974e9e”
    },
    “data”: {
        “type”: “us_visa_card”,
        “fields”: [
            {
                “name”: “number”,
                “type”: “string”,
                “regex”: “”,
                “is_required”: true,
                “instructions”: “card number”
            },
            {
                “name”: “expiration_month”,
                “type”: “string”,
                “regex”: “”,
                “is_required”: true,
                “instructions”: “expiration month as string, 01-12”
            },
            {
                “name”: “expiration_year”,
                “type”: “string”,
                “regex”: “”,
                “is_required”: true,
                “instructions”: “expiration year in to digits as string, 18-99"
            },
            {
                “name”: “cvv”,
                “type”: “string”,
                “regex”: “”,
                “is_required”: false,
                “instructions”: “card cvv”
            },
            {
                “name”: “name”,
                “type”: “string”,
                “regex”: “”,
                “is_required”: false,
                “instructions”: “card holder name”
            },
            {
                “name”: “address”,
                “type”: “Address”,
                “regex”: “”,
                “is_required”: false,
                “instructions”: “card billing address. see Address object for more details”
            }
        ],
        “payment_method_options”: [
            {
                “name”: “3d_required”,
                “type”: “string”,
                “regex”: “”,
                “description”: “”,
                “is_required”: false,
                “is_updatable”: false
            }
        ],
        “payment_options”: [
            {
                “name”: “customer”,
                “type”: “customer”,
                “regex”: “”,
                “description”: “make sure a customer was created with first_name, last_name and email”,
                “is_required”: true,
                “is_updatable”: false
            }
        ],
        “minimum_expiration_seconds”: null,
        “maximum_expiration_seconds”: null
    }
}
   

La respuesta muestra que, para obtener una tarjeta Visa de EE. UU., debes proporcionar:

número
mes_caducidad
año_caducidad
nombre
cvv

Asegúrese de que el cliente complete estos campos.

Cree la identificación del cliente y almacene la tarjeta

Cuando tu cliente guarda los detalles de su tarjeta, Rapyd crea un identificador de cliente único, almacena su tarjeta y la vincula a su identificador. Usa este identificador siempre que necesites que Rapyd gestione una solicitud para este cliente. Lo mínimo que necesitamos para la identificación es el nombre del cliente. Envía a Rapyd una solicitud para obtener el identificador de cliente y la tarjeta guardada

Para eso, utilizarás Crear cliente con los siguientes parámetros:

Descripción de los parámetros corporales

Parámetro corporal	Descripción
nombre	Entrar Jane Doe como nombre del cliente.
método_pago	Introduzca un objeto con los siguientes campos: `tipo` - us_debit_visa_card `campos` - Introduzca un objeto con los siguientes campos: `número` - 4 1111111 `mes_caducidad` - 10 `año_caducidad` - 20 `cvv` - 123 `nombre` - Jane Doe

Crear solicitud de cliente

Le pides a Rapyd que cree un identificador de cliente y un método de pago para tu cliente.

Solicitud

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

// Message body: 
{
    "name": "Jane Doe",
    "payment_method": {
        "type": "us_debit_visa_card",
        "fields": {
            "number": "4111111111111111",
            "expiration_month": "10",
            "expiration_year": "20",
            "cvv": "123",
            "name": "Jane Doe"
        }
    }
}

Pitón

from pprint import pprint

from utilities import make_request
                                            
customer_body = {
    "name": "Jane Doe",
    "payment_method": {
        "type": "us_visa_card",
        "fields": {
            "number": "4111111111111111",
            "expiration_month": "10",
            "expiration_year": "20",
            "cvv": "123",
            "name": "Jane Doe"
        }
    }
}
                                            
create_customer_response = make_request(method='post',
                                        path='/v1/customers',
                                        body=customer_body)
pprint(create_customer_response)

Crea una respuesta al cliente

Objeto de cliente describe los campos de la respuesta.

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "92b400c5-6c1d-484c-b327-bb7015897f89"
    },
    "data": {
        "id": "cus_8ded332b08966abf51bdc28c106acb7c",

        //      ...

        "name": "Jane Doe",
        "default_payment_method": "card_dbc9f6743ec2ab00486843edfdca42d9",

        //      ...

        "payment_methods": {
            "data": [
                {
                    "id": "card_dbc9f6743ec2ab00486843edfdca42d9",
                    "type": "us_debit_visa_card",
                    "category": "card",
                    "metadata": null,
                    "image": "https://iconslib.rapyd.net/checkout/us_visa_card.png",
                    "name": "Jane Doe",
                    "last4": "1111",
                    "cvv_check": "unchecked",

                    //      ...

                    "expiration_year": "20",
                    "expiration_month": "10",

                    //      ...

                }
            ],

            //      ...

            "url": "/v1/customers/cus_8ded332b08966abf51bdc28c106acb7c/payment_methods"
        },

        //      ...

        "created_at": 1581246256,

        //      ...

    }
}
   

El datos la sección de esta respuesta muestra que:

Rapyd crea un identificador de cliente para su cliente. El identificador de cliente comienza con cus_. Del cliente Id el valor en el código de ejemplo anterior, es cus_8ded332b08966abf51bdc28c106acb7c. Cuando ejecutes este ejemplo en tu propia zona de pruebas, obtendrás un ID de cliente diferente
Rapyd también crea un identificador de tarjeta para su cliente. El identificador de la tarjeta comienza con tarjeta_. La tarjeta Id en el código de ejemplo anterior es card_dbc9f6743ec2ab00486843edfdca42d9. Esta tarjeta ahora está almacenada como método_de_pago predeterminado.

Procesar el pago

Cuando tu cliente paga con la tarjeta almacenada, envías el pago a Rapyd para su procesamiento.

Para enviar el pago del cliente, usa Crear pago con los siguientes parámetros:

Descripción de los parámetros corporales

Parámetro corporal	Descripción
cantidad	Entrar 9.99 como importe del pago.
moneda	Entrar USD como código de divisa.
cliente	Introduce el «customer_id» que recibiste al crear el cliente en tu sandbox. Para los fines de esta lección de casos de uso, estamos usando cus_8ded332b08966abf51bdc28c106acb7c, que es el identificador de cliente que creamos en nuestra zona de pruebas.

Crear solicitud de pago

Solicita a Rapyd que procese el pago de 9,99 USD (dólares estadounidenses) de tu cliente (como se muestra en el código de ejemplo que aparece a continuación).

Solicitud

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

// Message body:
{
	"amount": 9.99,
	"currency": "USD",
	"customer": "cus_8ded332b08966abf51bdc28c106acb7c"
}

Pitón

from pprint import pprint

from utilities import make_request

payment_body = {
    "amount": 9.99,
    "currency": "USD",
    "customer": "cus_8ded332b08966abf51bdc28c106acb7c"
}

create_payment_response = make_request(method='post',
                                       path='/v1/payments',
                                       body=payment_body)
pprint(create_payment_response)

Crear respuesta de pago

Objeto de pago describe los campos de la respuesta.

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "4e44e8c1-ee8c-411a-a2de-a2a2ae0122d3"
    },
    "data": {
        "id": "payment_7b4cb9456f1ff73132831fc2e35d88be",
        "amount": 9.99,
        "original_amount": 9.99,
        "is_partial": false,
        "currency_code": "USD",
        "country_code": "US",
        "status": "CLO",

        //      ...

        "customer_token": "cus_8ded332b08966abf51bdc28c106acb7c",
        "payment_method": "card_dbc9f6743ec2ab00486843edfdca42d9",
        "expiration": 0,
        "captured": true,

        //      ...

        "created_at": 1581248060,

        //      ...

        "paid": true,
        "paid_at": 1581248060,

        //      ...

        "payment_method_type": "us_debit_visa_card",
        "payment_method_type_category": "card",

        //      ...

    }
}
   

La respuesta (en el código de ejemplo anterior) muestra que Rapyd procesó correctamente el pago en función del importe, la moneda y el identificador del cliente. Se pagó una suma de 9,99 USD (dólares estadounidenses) con la tarjeta del cliente.

Siempre obtendrás una respuesta similar. La única diferencia será la fecha y el identificador de pago, y el importe si no es idéntico.

Puede ver que el pago se realizó correctamente ya que estado (bajo datos) es CLO (cerrado). Objeto de pago enumera los valores posibles para estado.

En este punto, puedes informar al cliente de que la compra se ha completado.

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

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

En esta sección:

Documentación

Tarjeta archivada

Múltiples métodos de pago

Pago con tarjeta archivada

Flujo de trabajo de tarjeta en archivo

Paso 1: Guardar una tarjeta de cliente

Nota

Paso 2: Procesar el pago por primera vez

Paso 3: Iniciar una compra posterior

Paso 4: Procesar un pago posterior

Cómo funciona Card on File

Encuentra los métodos de pago disponibles

Solicitud de lista de métodos de pago por país

Lista de métodos de pago por país Respuesta

Nota

Busque los campos obligatorios para el método de pago

Obtener el método de pago Campos obligatorios Solicitud

Obtener el método de pago Campos obligatorios Respuesta

Cree la identificación del cliente y almacene la tarjeta

Crear solicitud de cliente

Crea una respuesta al cliente

Procesar el pago

Crear solicitud de pago

Crear respuesta de pago

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

Resultados de la búsqueda