Skip to main content

Documentación

Página alojada Guardar detalles de la tarjeta

Una página segura para guardar los detalles de su tarjeta.

La página alojada Guardar detalles de la tarjeta le permite almacenar de forma segura la información de la tarjeta de su cliente. La página Guarda los detalles de la tarjeta tokeniza los detalles de la tarjeta para que la información de pago confidencial se gestione de acuerdo con los estándares PCI-DSS. Rapyd realiza una autenticación de $0 para verificar la tarjeta.

Guardar los detalles de la tarjeta puede permitir una experiencia de pago más ágil. Su cliente puede añadir, guardar o eliminar varias tarjetas archivadas. Usted puede usar la información de pago guardada para futuros pagos de clientes.

  1. Ingrese la información de su tarjeta.

    hosted-save-card-details-flow-1.png
  2. Haga clic en Guardar tarjeta.

    hosted-save-card-details-flow-2.png
  3. Complete la verificación de la 3DS si es necesario.

  4. Redirígase a la página de administración de tarjetas.

    hosted-save-card-details-flow-3.png
  5. Haga clic en + Agregar nueva tarjeta para guardar los detalles de las tarjetas adicionales.

  6. (Opcional) Haga clic en el icono Eliminar junto al número de la tarjeta para eliminar una tarjeta guardada.

    hosted-save-card-details-flow-4.png
  7. Haga clic en Cerrar para salir de la página alojada.

hosted-save-card-details-flow-5.png
  1. Solicite a Rapyd que genere una página alojada Guardar detalles de la tarjeta.

  2. Rapyd procesa su solicitud y envía la respuesta con la URL de redireccionamiento.

  3. Muestre la URL de redireccionamiento al cliente.

  4. El cliente guarda los detalles de su tarjeta en la página alojada.

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

Crear token de tarjeta

create-card-token-without-3ds.svg

Crear un token de tarjeta con 3DS

create-card-token-with-3ds.svg

El siguiente diagrama de estados finitos resume los estados de las páginas alojadas con token de tarjeta.

hosted-page.svg

Descripción de los estados

Estado

Descripción

NUEVO

Nuevo: se creó la página alojada para el token de la tarjeta.

DON

Listo: la página alojada se completó. El token de la tarjeta se ha agregado al perfil del cliente.

EXP

Caducado: la página alojada para el token de la tarjeta ha caducado.

Debe completar los siguientes pasos para generar una página alojada Guardar detalles de la tarjeta:

  1. Cree un cliente (Integración de API o mediante el Client Portal)

  2. Genere una página alojada Guardar detalles de la tarjeta (integración de API o mediante el Client Portal)

Descripción de los parámetros del cuerpo

Vea Crear un token de tarjeta para obtener detalles adicionales sobre los parámetros.

Parámetro del cuerpo

Necesario

Descripción

país

El código ISO 3166-1 ALPHA-2 de dos letras para el país.

moneda

no

Cuando se especifica en la solicitud, define una moneda que no es la moneda predeterminada del país. Si no se especifica en la solicitud, la moneda predeterminada del país. Código ISO 4217 de tres letras

cliente

ID del cliente, una cadena que empieza por cus_.

auto_set_default

no

Cuando se especifique en la solicitud, establecer el valor en verdadero permitirá establecer el método de pago agregado como el método de pago predeterminado del cliente.

Si no se indica el valor, el valor predeterminado del parámetro es falso.

Generar una solicitud dejada página alojada Guardar detalles de la tarjeta
    • Solicitud

      • // Request URL: POST https://sandboxapi.rapyd.net/v1/hosted/collect/card                                        
        // Message body: 
                                                    
        {
            "country": "US",
            "currency": "USD",
            "customer": "cus_ecfab8b87e2fa11d66b95cc1f2c94037"
        }
Generar una respuesta de página alojada Guardar detalles de la tarjeta

Crear token de tarjeta describe los campos en la respuesta.

    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "e303abfa-f6c5-4906-b002-a1afdd4b1ee1"
            },
            "data": {
                "id": "hp_card_915d39ecc38cd02cd0c29d13ea8dc94e",
                "status": "NEW",
                "cancel_url": "https://www.rapyd.net",
                "complete_url": "https://www.rapyd.net",
                "language": null,
                "merchant_color": null,
                "merchant_logo": null,
                "merchant_website": "https://www.rapyd.net",
                "merchant_customer_support": {},
                "merchant_alias": "N/A",
                "page_expiration": 1708557501,
                "redirect_url": "https://sandboxhosted.rapyd.net/collect/card?token=hp_card_915d39ecc38cd02cd0c29d13ea8dc94e",
                "category": "card",
                "country": "US",
                "currency": "USD",
                "customer": "cus_ecfab8b87e2fa11d66b95cc1f2c94037",
                "payment_method_type": null,
                "payment_params": {
                    "complete_payment_url": null,
                    "error_payment_url": null
                },
                "billing_address_collect": false,
                "customer_card_payment_methods": null
            }
        }

Alojado

Kit de herramientas

Integración de API

Se requieren esfuerzos mínimos de los desarrolladores para la integración

Se requieren esfuerzos adicionales de los desarrolladores para la integración

Página personalizable (añadir un logotipo, cambiar el color del botón principal, las URL de los sitios web, los detalles de atención al cliente).

Los usuarios permanecen en su página web

Los usuarios son redirigidos a una página segura alojada en Rapyd

La integración del Kit de herramientas Rapyd se ha diseñado especialmente para integrarse directamente en su sitio web y dar a su empresa un mayor control sobre toda la experiencia.

Paso 1 - Antes de incrustar el iframe en su página, siga los pasos 1, 2 y 3 de la sección anterior para crear su página para guardar los detalles de la tarjeta.

Paso 2 - En el paso 3 (al generar la página), asegúrese de especificar también una complete_url y cancel_url

Nombre

Tipo

Descripción

complete_url

cadena de texto

URL a la que se redirige al cliente tras presionar Cerrar para salir de la página alojada.

cancel_url

cadena de texto

URL a la que se redirige al cliente tras presionar Volver al Sitio web para salir de la página alojada.

Paso 3 - Cuando haya creado la página para guardar los detalles de la tarjeta, en la respuesta recibirá el identificador del objeto de página, una cadena que empieza por «hp_card_» (por ejemplo: id: «hp_card_bd334669c8a80bc68c124b144c350b7f»).

Paso 4 - Añada el siguiente código a su página:

<script src="https://toolkit.rapyd.net"></script>

Nota

Para ejecutar este método en sandbox, use el siguiente código:

<script src="https://sandboxtoolkit.rapyd.net"></script>

Añada una etiqueta <div> con id="rapyd-toolkit":

<div id="rapyd-toolkit"></div>

Inicialice el objeto Guardar página de detalles de la tarjeta con los siguientes campos:

    • JavaScript

      • let toolkit = new RapydToolkit({    
                      button_text: "Save",
                              /* Text that appears on the Save button. 
                                  String. Maximum length is 16 characters.
                                  Default is "Save". Optional. */
                      button_color: "blue",
                              /* Color of the 'Save' button. String.
                                  Standard CSS color name or hexadecimal code such as #323fff.
                                  Default is the color that is returned in the 'merchant_color'
                                  field of the response to 'Save Card Details Page'. Optional.*/
                      id: "hp_card_bd334669c8a80bc68c124b144c350b7f",
                              /* ID of the 'Save Card Details Page' response. String. Required.*/
                      close_on_complete: true,
                              /* Causes the embedded Rapyd Toolkit window to close
                                  when the action is complete. Boolean. Default is 'true'. Optional.*/
                      wait_on_payment_redirect: false,
                              /* Default is 'false'. Optional.
                                 The iframe will close when the payment session has been completed.
                                 The user will redirect to complete the 3DS Verification. */       
                      page_type: “card_token”
                              /* Mandatory for save card details page
                                  Default is "collection". */
                          style: {
                              global: {
                                  fonts: [
                                      "https://fonts.googleapis.com/css2?family=Mulish:wght@200&amp;display=swap",
                                      {
                                          family: 'myCustomFont',
                                          src: '/fonts/myCustomFontRegular.woff2',
                                          fontWeight: 400
                                      },
                                      {
                                          family: 'myCustomFont',
                                          src: '/fonts/myCustomFontBold.woff2',
                                          fontWeight: 700
                                      }
                                  ]
                              },
                              save: {
                                  base: {
                                      backgroundColor: '#0000FF',
                                          // If passed for the 'Save' element, it will override the button_color field.
                                      fontFamily: 'myCustomFont',
                                              
                                  }
                              }  
                  });

Llame a Display Toolkit () para mostrar la página Guardar detalles de la tarjeta:

toolkit.displayToolkit();
          

Paso opcional: si close_on_complete está establecido en falso, llame Checkout.closeCheckout () para cerrar la ventana del Kit de herramientas de Checkout de Rapyd.

toolkit.closeToolkit();

Inserte el código que se ejecuta cuando se producen los siguientes eventos. Use su código para leer el campo del evento en el objeto «ventana».

    • JavaScript

      • window.addEventListener('onLoading', (event) => {
                            console.log(event.detail.loading)
                            // Returns true or false depending on the loading state
                            // Client code.
        })
        window.addEventListener('onSaveCardDetailsPending', (event) => {
                            console.log(event.detail.loading)
                            // Returns only when the parameter wait_on_payment_redirect = true
                            // Returns ‘Payment’ object.
                            // Client code.
        })
        window.addEventListener('onSaveCardDetailsSuccess', (event) => {
                            console.log(event.detail)
                            // if wait_on_payment_redirect = true then customer payment method object returns,
                            //else Returns ‘Payment’ object.
                            // Client code.
        })
                window.addEventListener('onSaveCardDetailsFailure', (event) => {
                            console.error(event.detail.error)
                            // Returns an error message from the API.
                            // Client code.
        })
  • Si la tarjeta se guarda correctamente, el cliente volverá a su sitio web según el código que introdujo para el evento Al guardar los detalles de la tarjeta correctamente.

  • Si el proceso falla, el cliente regresa a su sitio web, de acuerdo con el código que ingresó para el evento Error al guardar los detalles de la tarjeta.

Flujo 3D Secure:

En caso de que el cliente deba pasar por un proceso de autenticación de 3DS, la URL requerida se proporcionará en el campo redirect_url (que forma parte del objeto de pago). Asegúrese de redirigir al cliente a esta página.