Skip to main content

Documentación

Pagos con Tarjeta

Acepte de forma segura pagos con tarjeta de crédito y débito, tanto locales como internacionales, en todo el mundo.

Un pago con tarjeta se inicia cuando su cliente selecciona el pago con tarjeta desde su lista de métodos de pago o ingresa los datos de su tarjeta en los campos del formulario de tarjeta.

La iniciación de un pago con tarjeta consta de lo siguiente:

  • Monto de autorización.

  • captura exitosa de la transacción autorizada.

De forma predeterminada, todos los pagos con tarjeta se capturan inmediatamente después de la autorización; sin embargo, en algunos casos se puede utilizar un proceso de captura posterior para retener los fondos.

Las transacciones iniciadas por el comerciante (MIT) son transacciones con tarjeta iniciadas por el comerciante, en las que el titular de la tarjeta no está presente.

Para ciertos tipos de métodos de pago, puedes incluir el initiation_type campo de la solicitud. Esto le permite volver a autorizar un pago con tarjeta o capturar fondos en una fecha posterior

Los comerciantes pueden iniciar transacciones con tarjeta con el esquema de tarjetas en circunstancias específicas. Estas situaciones implican que el comerciante deba cobrar comisiones de servicio o extender una autorización para una tarjeta registrada. La captura de fondos puede tener lugar días o semanas después del pago inicial y se inicia sin la presencia del titular

Los siguientes casos de uso demostrarán la importancia de los tipos de inicio para no se presenta, cargos retrasados, y reautorizaciones para pagos con tarjeta en una variedad de industrias.

No se presenta

A no se presenta se produce cuando un cliente no llega para recibir un servicio acordado, como una reserva de hotel o un alquiler de coche. Este escenario demuestra la transición de una transacción iniciada por el cliente (CIT) a una transacción iniciada por el comerciante (MIT

Un cliente reserva online una estancia de una noche en un hotel. Durante el proceso de salida, proporciona los datos de su tarjeta y acepta una política de cancelación que establece que se cobrará la primera noche si no se presenta. En este momento, el comerciante puede realizar una preautorización para verificar los fondos o simplemente guardar la tarjeta como credencial archivada (CoF

El cliente no llega en la fecha de entrada programada y no cancela la reserva. Como el cliente no está presente para pasar su tarjeta o proporcionar una nueva firma, el comerciante debe iniciar el cargo. Si existe una autorización previa pero el comerciante necesita procesar una multa específica, o si la retención original ha caducado, el comerciante envía una

Esta solicitud incluye la iniciation_type: no_show y hace referencia al pago_original ID de la reserva.

Cargos retrasados

A cargo retrasado es cuando se presenta un cargo una vez finalizado el servicio principal.

Un huésped se registra en un hotel para una estancia de tres noches. Al registrarse, el hotel realiza una autorización estándar sobre el costo de la habitación y los impuestos. La estancia de los huéspedes transcurre con normalidad y se van sin pasar por la recepción.

Cuando el huésped se va, el personal de limpieza del hotel inspecciona la habitación y descubre que el huésped consumió varios artículos del minibar y pidió una película en la televisión. Estos cargos, que suman un total de 75$, no estaban incluidos en el precio inicial de la habitación porque se produjeron después de que se procesara el pago inicial y el huésped ya se había

Dado que el huésped aceptó los términos y condiciones del hotel al registrarse (lo que otorga al hotel el derecho a cobrar por gastos imprevistos), el sistema del hotel ahora puede realizar un cargo retrasado iniciado por el comerciante. El sistema del hotel envía una nueva solicitud de transacción por 75 dólares a la pasarela de pago. La transacción se marca como «cargo retrasado» y hace referencia a la autorización original o al token registrado en la tarjeta. Este cargo se procesa sin tener que pasar una nueva tarjeta ni sin la presencia del titular de la

El cargo es un cargo retrasado porque se envía una vez finalizado el servicio principal (la estancia en el hotel) y el huésped se ha marchado. El momento del cobro no está sincronizado con el servicio en sí. El cargo iniciado por el comerciante porque el cobro lo inicia el sistema del hotel, no el cliente (que ya no está presente para pasar su tarjeta). Se basa en el acuerdo preexistente y en los detalles de la tarjeta almacenados «en el archivo». »

Este proceso es fundamental para las empresas con cargos de posventa impredecibles. Les permite recaudar ingresos por los servicios utilizados sin necesidad de que el cliente esté físicamente presente para la transacción final

Reautorización

A reautorización es cuando la autorización original para un pago ha caducado, pero la entrega del servicio o producto no está del todo completa. Esto permite al comerciante volver a asegurar los fondos sin que el cliente tenga que estar presente. Los casos de uso más comunes están relacionados con plazos prolongados para los servicios o

Envío dividido o retrasado

Un cliente hace un pedido de varios artículos a un minorista en línea. El valor total del pedido es de 300$. El sistema del minorista realiza una sola autorización por el importe total. Se retienen 300 dólares en la tarjeta del cliente. Por lo general, es válido durante 5 a 7 días.

Resulta que uno de los artículos está pendiente de entrega y no estará disponible para su envío hasta dentro de dos semanas. El minorista debe capturar los fondos del primer envío ahora, pero también debe asegurarse de que los fondos estén disponibles para el segundo envío posterior, una vez que haya caducado la autorización inicial

El vendedor captura los fondos del primer envío (por ejemplo, 150 USD) de la autorización original. A medida que se acerca la fecha de caducidad de la autorización original, el sistema del vendedor inicia automáticamente reautorizar una transacción iniciada por el comerciante (MIT) por el saldo restante (150$). La solicitud de reautorización se envía al banco emisor, que retiene la tarjeta por un nuevo importe de 150 USD. Se procesa como una transacción iniciada por el comerciante porque el cliente no participa activamente en la transacción

Esta nueva autorización es válida durante otros 5 a 7 días y asegura los fondos hasta que el segundo envío esté listo para ser entregado y capturado.

Alquiler extendido de vehículos

Inicialmente, un cliente alquila un automóvil de lujo para un arrendamiento a largo plazo de 45 días. La política de la empresa de alquiler consiste en realizar una preautorización por el importe total conocido del arrendamiento más un depósito de garantía, por un total de 15

Al comienzo del período de alquiler, la empresa de alquiler realiza una preautorización por valor de 15 000$. Esta retención es válida durante un máximo de 30 días, según las normas de la red de tarjetas para este código de categoría de comerciante (MCC

El cliente sigue en posesión del vehículo después de 30 días. La preautorización original de 15 000$ está a punto de caducar. La empresa de alquiler debe mantener una autorización válida en la tarjeta para garantizar que los fondos estén asegurados durante los 15 días restantes del período de alquiler

A medida que se acerca la fecha de caducidad de 30 días de la autorización original, el sistema de la empresa de alquiler inicia automáticamente una reautorizar una transacción iniciada por el comerciante (MIT). El sistema envía una nueva solicitud al banco emisor por el mismo importe de 15 000$. Esto se marca explícitamente como una reautorización

El banco emisor aprueba la nueva solicitud de autorización y se retiene la tarjeta durante 30 días por valor de 15 000$. Se procesa como una transacción iniciada por el comerciante porque el cliente no está presente para volver a

Al final del período de alquiler de 45 días, la empresa de alquiler captura el importe final acordado de la última autorización válida.

Este ejemplo destaca una razón legítima para usar un MIT de reautorización: mantener una retención segura de los fondos de un cliente para un servicio que se extiende más allá de la duración máxima permitida de una sola autorización.

card-payment-workflow.jpg
  1. El cliente completa el pago con tarjeta en el proceso de pago de su sitio web.

  2. Un proveedor de tokens de terceros solicita un token de red.

  3. Usted solicita a Rapyd que procese el pago con tarjeta utilizando un token de red.

  4. Rapyd procesa el pago y le envía la respuesta y el webhook.

  5. Usted muestra la página de compra exitosa al cliente.

Certificación PCI

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

Decida los tipos de pago con tarjeta que aceptará en un país determinado. Utilice Listar métodos de pago por país con los siguientes parámetros:

  • En los ejemplos de código a continuación, se utilizan GB y GBP como país y moneda. Tarjeta Visa GB como tipo de pago.

Descripción de los Parámetros de Consulta

Parámetro de consulta

Descripción

País

Ingrese GB como el código del país.

Moneda

Ingrese GBP como el código de la moneda.

Solicitud de Listar Métodos de Pago por País
    • Solicitud

      • // Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/country?currency=GBP&country=AT
        
        // Message body absent
Respuesta de Listar Métodos de Pago por País
    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "01f4860c-9eb4-41d6-8ef8-a62b0872ccc3"
            },
            "data": [
                {
                    "type": "at_amex_pos",
                    "name": "AustriaAmex POS PMT",
                    "category": "pos",
                    "image": "",
                    "country": "AT",
                    "payment_flow_type": "",
                    "currencies": [
                        "GBP"
                    ],
                    "status": 1,
                    "is_cancelable": true,
                    "payment_options": [
                        {
                            "name": "capture",
                            "type": "boolean",
                            "regex": "",
                            "description": "Determines when the payment is processed for capture.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "statement_descriptor",
                            "type": "string",
                            "regex": "",
                            "description": "A text description suitable for a customer's payment statement. 5-22 characters.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "ewallet",
                            "type": "string",
                            "regex": "^ewallet_[a-f0-9]{32}$",
                            "description": "ID of the wallet that the money is paid into. String starting with ewallet_.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "initiation_type",
                            "type": "string",
                            "regex": "(card_present|customer_present|installment|moto|recurring|unscheduled)",
                            "description": "How the transaction was initiated.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "device_id",
                            "type": "string",
                            "regex": "",
                            "description": "Unique ID from POS provider.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "payment_advice",
                            "type": "object",
                            "regex": "",
                            "description": "Raw JSON from POS device.",
                            "is_required": true,
                            "is_updatable": false
                        }
                    ],
                    "is_expirable": true,
                    "is_online": false,
                    "is_refundable": true,
                    "minimum_expiration_seconds": 0,
                    "maximum_expiration_seconds": 2592000,
                    "virtual_payment_method_type": null,
                    "is_virtual": false,
                    "multiple_overage_allowed": false,
                    "amount_range_per_currency": [
                        {
                            "currency": "GBP",
                            "maximum_amount": null,
                            "minimum_amount": null
                        }
                    ],
                    "is_tokenizable": false,
                    "supported_digital_wallet_providers": [],
                    "is_restricted": false,
                    "supports_subscription": false,
                    "supports_aft": false
                },
                {
                    "type": "at_mastercard_card",
                    "name": "Mastercard",
                    "category": "card",
                    "image": "https://iconslib.rapyd.net/checkout/at_mastercard_card.png",
                    "country": "AT",
                    "payment_flow_type": "",
                    "currencies": [
                        "GBP"
                    ],
                    "status": 1,
                    "is_cancelable": true,
                    "payment_options": [
                        {
                            "name": "capture",
                            "type": "boolean",
                            "regex": "",
                            "description": "Determines when the payment is processed for capture.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "complete_payment_url",
                            "type": "string",
                            "regex": "",
                            "description": "the complete_payment_url field must be filled in.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "error_payment_url",
                            "type": "string",
                            "regex": "",
                            "description": "the error_payment_url field must be filled in.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "customer",
                            "type": "string",
                            "regex": "",
                            "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "ewallet",
                            "type": "string",
                            "regex": "^ewallet_[a-f0-9]{32}$",
                            "conditions": [
                                {
                                    "operator": "$eq",
                                    "description": "If the value of the field type is true, ewallet is mandatory field",
                                    "element_name": "payment.payment_method_options.aft",
                                    "threshold_value": "true"
                                }
                            ],
                            "description": "ID of the wallet that the money is paid into. String starting with ewallet_.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "initiation_type",
                            "type": "string",
                            "regex": "(customer_present|installment|moto|recurring|unscheduled)",
                            "description": "This indicates how the transaction was initiated",
                            "is_required": false,
                            "is_updatable": false
                        }
                    ],
                    "is_expirable": true,
                    "is_online": false,
                    "is_refundable": true,
                    "minimum_expiration_seconds": 600,
                    "maximum_expiration_seconds": 604800,
                    "virtual_payment_method_type": null,
                    "is_virtual": false,
                    "multiple_overage_allowed": false,
                    "amount_range_per_currency": [
                        {
                            "currency": "GBP",
                            "maximum_amount": null,
                            "minimum_amount": null
                        }
                    ],
                    "is_tokenizable": false,
                    "supported_digital_wallet_providers": [],
                    "is_restricted": false,
                    "supports_subscription": true,
                    "supports_aft": true
                },
                {
                    "type": "at_visa_card",
                    "name": "Visa",
                    "category": "card",
                    "image": "https://iconslib.rapyd.net/checkout/at_visa_card.png",
                    "country": "AT",
                    "payment_flow_type": "",
                    "currencies": [
                        "GBP"
                    ],
                    "status": 1,
                    "is_cancelable": true,
                    "payment_options": [
                        {
                            "name": "capture",
                            "type": "boolean",
                            "regex": "",
                            "description": "Determines when the payment is processed for capture.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "complete_payment_url",
                            "type": "string",
                            "regex": "",
                            "description": "the complete_payment_url field must be filled in.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "error_payment_url",
                            "type": "string",
                            "regex": "",
                            "description": "the error_payment_url field must be filled in.",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "customer",
                            "type": "string",
                            "regex": "",
                            "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                            "is_required": true,
                            "is_updatable": false
                        },
                        {
                            "name": "ewallet",
                            "type": "string",
                            "regex": "^ewallet_[a-f0-9]{32}$",
                            "conditions": [
                                {
                                    "operator": "$eq",
                                    "description": "If the value of the field type is true, ewallet is mandatory field",
                                    "element_name": "payment.payment_method_options.aft",
                                    "threshold_value": "true"
                                }
                            ],
                            "description": "ID of the wallet that the money is paid into. String starting with ewallet_.",
                            "is_required": false,
                            "is_updatable": false
                        },
                        {
                            "name": "initiation_type",
                            "type": "string",
                            "regex": "(customer_present|installment|moto|recurring|unscheduled)",
                            "description": "This indicates how the transaction was initiated",
                            "is_required": false,
                            "is_updatable": false
                        }
                    ],
                    "is_expirable": true,
                    "is_online": false,
                    "is_refundable": true,
                    "minimum_expiration_seconds": 600,
                    "maximum_expiration_seconds": 604800,
                    "virtual_payment_method_type": null,
                    "is_virtual": false,
                    "multiple_overage_allowed": false,
                    "amount_range_per_currency": [
                        {
                            "currency": "GBP",
                            "maximum_amount": null,
                            "minimum_amount": null
                        }
                    ],
                    "is_tokenizable": false,
                    "supported_digital_wallet_providers": [],
                    "is_restricted": false,
                    "supports_subscription": true,
                    "supports_aft": true
                }
            ]
        }

Utilice Obtener campos requeridos del método de pago con el siguiente parámetro:

La sección datos de esta respuesta muestra que una tarjeta Visa es un tipo de método de pago aceptable.

Descripción de los Parámetros de Ruta

Parámetro de ruta

Descripción

Tipo

Ingrese gb_visa_card como el tipo de método de pago.

Solicitud de Obtener los Campos Requeridos del Método de Pago

Solicite un conjunto de campos requeridos para una tarjeta Visa.

    • Solicitud

      • // Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/required_fields/at_visa_card
        
        // Message body absent
Respuesta de Obtener los Campos Requeridos del Método de Pago

La respuesta a continuación muestra que, para una tarjeta Visa GB, el cliente debe completar los siguientes campos:

  • número

  • mes_expiración 

  • año_expiración

  • nombre

  • CVV

    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "2193102d-5730-4fc5-af45-62105389c05b"
            },
            "data": {
                "type": "at_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": true,
                        "instructions": "card cvv"
                    },
                    {
                        "name": "name",
                        "type": "string",
                        "regex": "",
                        "is_required": true,
                        "instructions": "card holder name"
                    },
                    {
                        "name": "network_reference_id",
                        "type": "string",
                        "regex": "",
                        "description": "Network Reference Id",
                        "is_required": false
                    },
                    {
                        "name": "recurrence_type",
                        "type": "string",
                        "regex": "(recurring|installment|unscheduled)",
                        "description": "Indicates how the token will be used. Required when this payment method is added to the customer profile. Values: 'unscheduled'=Individual unrelated payments. 'installment'=Regular payments for a defined number of payment cycles. 'recurring'=Regular payments for an indefinite period.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "number_type",
                        "type": "string",
                        "regex": "(fpan|tpan)",
                        "description": "Determining if number is funding PAN or token PAN",
                        "is_required": false
                    }
                ],
                "payment_method_options": [
                    {
                        "name": "aft",
                        "type": "boolean",
                        "regex": "",
                        "description": "Allows the client to determine whether the request is an AFT request",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "3d_required",
                        "type": "boolean",
                        "regex": "",
                        "description": "Allows the client to determine whether the customer is required to complete 3DS authentication for the transaction",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "3d_version",
                        "type": "String",
                        "regex": "(1.0.2|2.1.0|2.2.0)",
                        "description": "3D Secure version of the transaction.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "cavv",
                        "type": "String",
                        "regex": "",
                        "description": "Cardholder Authentication Verification Value represented as a 20-byte value that is base64 encoded.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "eci",
                        "type": "String",
                        "regex": "(01|02|05|06|07|08)",
                        "description": "Electronic Commerce Indicator (ECI) from MPI Plugin(3-D Secure 1.0) or 3DS Server(3-D Secure 2.0).",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "xid",
                        "type": "String",
                        "regex": "",
                        "description": "3D Secure XID, Base64 encoded.Required for VISA 1.0",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "ds_trans_id",
                        "type": "String",
                        "regex": "",
                        "description": "The Directory Server (DS) Transaction ID. Required Mastercard 2.0.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "tavv",
                        "type": "String",
                        "regex": "",
                        "description": "Token Authentication Verification Value represented as a 20-byte value that is base64 encoded.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "cvv",
                        "type": "string",
                        "regex": "",
                        "description": "Card CVV for Subsequent Payments",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "currency",
                        "type": "string",
                        "regex": "",
                        "description": "Three-letter ISO 4217 code, defines the currency of the transaction.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "special_condition_indicator",
                        "type": "String",
                        "regex": "",
                        "description": "Indicator of transactions that are considered high risk, e.g. the purchase of cryptocurrency.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "purpose_code",
                        "type": "string",
                        "regex": "(family_support|regular_labor_transfers|travel_and_tourism|education|hospitalization_and_medical_treatment|emergency_need|savings|gifts|other|salary|crowd_lending|crypto_currency|high_risk_securities)",
                        "description": "The code that identifies the reason for the transaction. Required only for AFT transactions.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "sca_exemption",
                        "type": "string",
                        "regex": "(low_value|transaction_risk_analysis|authentication_outage|secure_corporate_payments)",
                        "description": "Request a strong customer authentication (SCA) exemption from 3D Secure (3DS) authentication for a merchant of a payment facilitator (PayFac). Specify one exemption type. To enable this feature, contact Rapyd Client Support.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "is_direct_purchase",
                        "type": "boolean",
                        "regex": "",
                        "description": "The merchant to specify if its wallet load or a direct purchase.",
                        "is_required": false,
                        "is_updatable": false
                    }
                ],
                "payment_options": [
                    {
                        "name": "capture",
                        "type": "boolean",
                        "regex": "",
                        "description": "Determines when the payment is processed for capture.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "complete_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the complete_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "error_payment_url",
                        "type": "string",
                        "regex": "",
                        "description": "the error_payment_url field must be filled in.",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "customer",
                        "type": "string",
                        "regex": "",
                        "description": "ID of a customer object, a string starting with ‘cus_‘. The customer object must contain the fields listed as required, and can contain additional fields listed here.If the customer object does not exist yet, use ‘Create Customer‘",
                        "is_required": true,
                        "is_updatable": false
                    },
                    {
                        "name": "ewallet",
                        "type": "string",
                        "regex": "^ewallet_[a-f0-9]{32}$",
                        "conditions": [
                            {
                                "operator": "$eq",
                                "description": "If the value of the field type is true, ewallet is mandatory field",
                                "element_name": "payment.payment_method_options.aft",
                                "threshold_value": "true"
                            }
                        ],
                        "description": "ID of the wallet that the money is paid into. String starting with ewallet_.",
                        "is_required": false,
                        "is_updatable": false
                    },
                    {
                        "name": "initiation_type",
                        "type": "string",
                        "regex": "(customer_present|installment|moto|recurring|unscheduled)",
                        "description": "This indicates how the transaction was initiated",
                        "is_required": false,
                        "is_updatable": false
                    }
                ],
                "minimum_expiration_seconds": 600,
                "maximum_expiration_seconds": 604800
            }
Iniciar el Pago de su Cliente

Recaude un pago de su cliente:

Descripción de los Parámetros del Cuerpo

Parámetro del cuerpo

Descripción

método_pago

Ingrese un objeto con los siguientes campos: tipo - gb_visa_card campos - Ingrese un objeto con los siguientes campos: número - 4 1111111 mes_expiración - 10 año_de expiración - 29 cvv - 123

tipo - at_visa_card

campos - Introduzca un objeto con los siguientes campos:

  • número - 4 1111111

  • mes_caducidad - 10

  • año_de_caducidad - 29

  • cvv - 123

Monto

Ingrese 9.99 como el monto del pago.

Moneda

Ingrese GBP como el código de la moneda.

Captura

Ingrese verdadero como el valor. Esto indica a Rapyd que recaude el pago de inmediato. Si el valor es «falso», se colocará una retención en la tarjeta y los fondos no se capturarán hasta que el estado sea actualizado.

tipo_inicio

Introduzca uno de los valores siguientes:

  • cliente_presente

  • cuota

  • moto

  • recurrente

  • no programado

  • cargos_retrasados

  • reautorización

  • no_show

Enviar el Pago a Rapyd

Rapyd procesa el pago con tarjeta de su cliente y captura los fondos de inmediato(en el código de ejemplo, el monto utilizado es 9.99 GBP).

Crear Solicitud de Pago
    • Solicitud

      • // Request URL: POST https://sandboxapi.rapyd.net/v1/payments
        
        // Message body: 
        {
            "amount": 50,
            "currency": "GBP",
            "capture": true,
            "save_payment_method": true,
            "original_payment": "payment_6878e51a572cd5450062028b52957220",
            "initiation_type": "no_show",
            "payment_method": {
                "type": "at_visa_card",
                "fields": {
                    "number": "4111111111111111",
                    "expiration_month": "12",
                    "expiration_year": "25",
                    "cvv": "123",
                    "name": "John Doe"
                }
            },
            "complete_payment_url": "https://complete.rapyd.net",
            "error_payment_url": "https://error.rapyd.net"
        }
Crear Respuesta de Pago
    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "a313e62b-ea89-4690-a22b-f04172c79f85"
            },
            "data": {
                "id": "payment_f7d78165bed5ac105ead1499b1633f71",
                "amount": 50,
                "original_amount": 50,
                "is_partial": false,
                "currency_code": "GBP",
                "country_code": "AT",
                "status": "CLO",
                "description": "",
                "merchant_reference_id": "",
                "customer_token": "cus_40a77ebd45ff40b83161e60ea602ce66",
                "payment_method": "card_e15fee15b3ff0cc14cfceedc18093281",
                "payment_method_data": {
                    "id": "card_e15fee15b3ff0cc14cfceedc18093281",
                    "type": "at_visa_card",
                    "category": "card",
                    "metadata": null,
                    "image": "",
                    "webhook_url": "",
                    "supporting_documentation": "",
                    "next_action": "not_applicable",
                    "name": "John Doe",
                    "last4": "1111",
                    "acs_check": "unchecked",
                    "cvv_check": "pass",
                    "bin_details": {
                        "type": "DEBIT",
                        "brand": "VISA",
                        "level": "GOLD",
                        "issuer": "INTL HDQTRS-CENTER OWNED",
                        "country": "SG",
                        "bin_number": "411111"
                    },
                    "expiration_year": "25",
                    "expiration_month": "12",
                    "fingerprint_token": "ocfp_b8eafaeeea548e97ef23914cffa7154a",
                    "network_reference_id": "00000******2",
                    "payment_account_reference": "V0010013018036782991622965076"
                },
                "auth_code": 823886,
                "expiration": 17623******00,
                "captured": true,
                "refunded": false,
                "refunded_amount": 0,
                "receipt_email": "",
                "redirect_url": "",
                "complete_payment_url": "https://complete.rapyd.net",
                "error_payment_url": "https://error.rapyd.net",
                "receipt_number": "",
                "flow_type": "",
                "address": null,
                "statement_descriptor": "merchant-1",
                "transaction_id": "",
                "created_at": 17618******63,
                "metadata": {},
                "failure_code": "",
                "failure_message": "",
                "paid": true,
                "paid_at": 17618******64,
                "dispute": null,
                "refunds": null,
                "order": null,
                "outcome": null,
                "visual_codes": {},
                "textual_codes": {},
                "instructions": [],
                "ewallet_id": "ewallet_6f288d7c178f545ebb56be8990ff0ff2",
                "ewallets": [
                    {
                        "ewallet_id": "ewallet_6f288d7c178f545ebb56be8990ff0ff2",
                        "amount": 50,
                        "percent": 100,
                        "refunded_amount": 0
                    }
                ],
                "payment_method_options": { 
        	    "3d_required": false
        	    },
                "payment_method_type": "at_visa_card",
                "payment_method_type_category": "card",
                "fx_rate": 1,
                "merchant_requested_currency": null,
                "merchant_requested_amount": null,
                "fixed_side": "",
                "payment_fees": null,
                "invoice": "",
                "escrow": null,
                "group_payment": "",
                "cancel_reason": null,
                "initiation_type": "no_show",
                "mid": "mid_1ab3788e7e7e423ea990a48073d8b2b1",
                "next_action": "not_applicable",
                "error_code": "",
                "remitter_information": {},
                "save_payment_method": true,
                "merchant_advice_code": null,
                "merchant_advice_message": null,
        	"payment_request_id": null,		
                "transaction_link_id": null,
        	"original_payment": "payment_6878e51a572cd5450062028b52957220"
            }
        }

La respuesta muestra que Rapyd procesó el pago correctamente según el monto, la moneda y el método de pago.

El pago es exitoso, ya que el estado (dentro de datos) es CLO (cerrado).

Ahora puede notificar a su cliente que la compra se ha completado.