Skip to main content

Documentación

Guarde los detalles de la tarjeta con Rapyd Checkout

La página Rapyd Checkout te permite guardar los detalles de la tarjeta de un cliente cuando realiza un pago. Puedes usar la información de pago guardada para futuros pagos

La información de la tarjeta guardada se tokeniza, lo que sigue los estándares PCI-DSS. Esto permite que la información confidencial se almacene de forma segura. Guardar los detalles de la tarjeta en la página de pago de Rapyd te permite vincular los detalles de la tarjeta con los del cliente

  1. Ingresa la información de tu tarjeta.

    save-card-details-rapyd-checkout-flow-1.png
  2. (Opcional): haga clic en Guarde la tarjeta para futuros pagos casilla de verificación.

  3. Haga clic Haga su pedido para completar el pago.

  4. Redirigir a la página de éxito del pago.

  5. Haga clic Finalizar.

payment-links-flow-4.png
  1. Solicitas a Rapyd que genere una página de pago alojada.

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

  3. Muestras la URL de redireccionamiento al cliente.

  4. El cliente completa el pago en la página alojada.

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

Pago con tarjeta Rapyd Checkout: éxito

checkout-card-success.svg

Pago con tarjeta Pago rápido: error

checkout-card---payment-declined.svg

Debes completar los siguientes pasos para generar una página de pago alojada:

  1. Crear un cliente (Integración de API o mediante el portal del cliente)

  2. Genere una página de pago alojada (integración de API o mediante el portal del cliente)

Debes pasar el identificador de cliente (una cadena que empieza por cus_) en la solicitud al generar la página de pago alojada. Esto permite guardar los detalles de la tarjeta para futuros pagos.

Descripción de los parámetros corporales

Ver Crear página de pago para obtener detalles adicionales sobre los parámetros.

Parámetro corporal

Necesario

Descripción

cantidad

El importe del pago, en unidades monetarias definidas en moneda.

país

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

moneda

Código ISO 4217 de tres letras para la moneda.

cliente

no

ID del cliente, una cadena que empieza por cus_.

Nota: Debe incluirse para poder guardar los detalles de la tarjeta.

Solicitud de creación de página de pago
    • Solicitud

      • // Request URL: POST https://sandboxapi.rapyd.net/v1/checkout                                        
        // Message body: 
                                                    
        {
            "amount": 123.45,
            "complete_payment_url": "http://example.com/complete",
            "country": "GB",
            "currency": "GBP",
            "customer": "cus_ecfab8b87e2fa11d66b95cc1f2c94037",
            "error_payment_url": "http://example.com/error",
            "merchant_reference_id": "950ae8c6-78",
            "cardholder_preferred_currency": true,
            "language": "en",
            "metadata": {
                "merchant_defined": true
            },
                                                      
            "expiration": 1708498532,
            "payment_method_types_exclude": []
        }
Crear respuesta en la página de pago

Crear página de pago describe los campos de la respuesta.

    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "47d0211e-9da3-4846-ae28-f7fc1d2438da"
            },
            "data": {
                "id": "checkout_0d7e080a7162c785ebcb8b416b1c0860",
                "status": "NEW",
                "language": "en",
                "merchant_color": null,
                "merchant_logo": null,
                "merchant_website": "https://www.rapyd.net",
                "merchant_customer_support": {},
                "merchant_alias": "N/A",
                "merchant_terms": null,
                "merchant_privacy_policy": null,
                "page_expiration": 1708565261,
                "redirect_url": "https://sandboxcheckout.rapyd.net/?token=checkout_0d7e080a7162c785ebcb8b416b1c0860",
                "merchant_main_button": "place_your_order",
                "cancel_checkout_url": "https://www.rapyd.net",
                "complete_checkout_url": "https://www.rapyd.net",
                "country": "GB",
                "currency": "GBP",
                "amount": 123.45,
                "payment": {
                    "id": null,
                    "amount": 123.45,
                    "original_amount": 0,
                    "is_partial": false,
                    "currency_code": "GBP",
                    "country_code": "GB",
                    "status": null,
                    "description": "Payment via Checkout",
                    "merchant_reference_id": "950ae8c6-78",
                    "customer_token": "cus_ecfab8b87e2fa11d66b95cc1f2c94037",
                    "payment_method": null,
                    "payment_method_data": {},
                    "expiration": 1708498532,
                    "captured": false,
                    "refunded": false,
                    "refunded_amount": 0,
                    "receipt_email": null,
                    "redirect_url": null,
                    "complete_payment_url": "http://example.com/complete",
                    "error_payment_url": "http://example.com/error",
                    "receipt_number": null,
                    "flow_type": null,
                    "address": null,
                    "statement_descriptor": null,
                    "transaction_id": null,
                    "created_at": 0,
                    "updated_at": 0,
                    "metadata": {
                        "merchant_defined": true
                    },
                    "failure_code": null,
                    "failure_message": null,
                    "paid": false,
                    "paid_at": 0,
                    "dispute": null,
                    "refunds": null,
                    "order": null,
                    "outcome": null,
                    "visual_codes": {},
                    "textual_codes": {},
                    "instructions": {},
                    "ewallet_id": null,
                    "ewallets": [],
                    "payment_method_options": {},
                    "payment_method_type": null,
                    "payment_method_type_category": null,
                    "fx_rate": null,
                    "merchant_requested_currency": null,
                    "merchant_requested_amount": null,
                    "fixed_side": null,
                    "payment_fees": null,
                    "invoice": null,
                    "escrow": null,
                    "group_payment": null,
                    "cancel_reason": null,
                    "initiation_type": null,
                    "mid": null,
                    "next_action": "not_applicable"
                },
                "payment_method_type": null,
                "payment_method_type_categories": null,
                "payment_method_types_include": null,
                "payment_method_types_exclude": [],
                "account_funding_transaction": null,
                "customer": "cus_ecfab8b87e2fa11d66b95cc1f2c94037",
                "custom_elements": {
                    "save_card_default": false,
                    "display_description": false,
                    "payment_fees_display": true,
                    "merchant_currency_only": false,
                    "billing_address_collect": false,
                    "dynamic_currency_conversion": false
                },
                "timestamp": 1707355661,
                "payment_expiration": null,
                "cart_items": [],
                "escrow": null,
                "escrow_release_days": null
            }
        }