Página de pago de suscripciones alojada
Una página segura para aceptar los pagos de tus suscripciones.
Las suscripciones son transacciones recurrentes basadas en ciclos de facturación predefinidos. Las suscripciones funcionan bien para las empresas que ofrecen un servicio que se puede renovar de forma regular.
La página de pago de suscripciones alojadas te permite cobrar pagos periódicos por productos a través del plan de precio fijo. Esta solución alojada te permite gestionar de forma eficaz las suscripciones de tu organización y cobrar los pagos de los clientes de forma más sencilla al dirigirlos a la página de pago de las suscripciones alojadas.
Los casos de uso comunes pueden incluir:
Acepta pagos recurrentes de tus clientes sin tener que gestionar la información de sus tarjetas de crédito.
Ofrecer una solución de suscripciones a otras empresas o comerciantes sin un PCI-DSS certificación.
Una solución sin código para generar una página de suscripciones a través del Portal del cliente.
Introduce tu información de pago.
Ingresa tu dirección y dirección de facturación.
Haga clic Suscríbase.
Completa la verificación de la 3DS.
Redirigir a la suscripción exitosa página.
Haga clic Finalizar.
Métodos de pago compatibles
Se admiten los siguientes métodos de pago para la página de pago de suscripciones alojada:
Cartas
Redireccionamiento bancario
Paso 1: Crea un producto para tu suscripción
Decide el producto que vas a usar para tu suscripción.
Utilice Crear producto para generar el producto que se utilizará en la descripción. Suscripciones: crea un producto para obtener más información sobre los parámetros.
Nota: Un producto utilizado en los planes de precios debe tener sus
tipoestablecido en servicio.Rapyd genera un identificador de producto.
Rapyd envía una respuesta de webhook.
Paso 2: Crea un plan para tu suscripción
Tú decides la configuración de precios de tu plan de precios.
Utilice Crear plan para generar tu plan. Suscripciones: cree un plan para obtener más información sobre los parámetros.
Rapyd genera un ID de plan.
Rapyd envía una respuesta de webhook.
Nota: La página de suscripción alojada solo se puede generar con el plan de precio fijo.
Paso 3: Crea un cliente para tu suscripción.
Utilice Crear cliente para generar un cliente a través de la API para su suscripción.
Le pides a Rapyd que genere un identificador de cliente. Consulte Suscripciones: cree un perfil de cliente para obtener más información sobre los parámetros.
Rapyd genera un identificador de cliente único.
Nota: Consulta Crear una suscripción por página alojada para obtener más información sobre cómo generar una página de pago de una suscripción alojada sin ID de cliente.
Paso 4: Generar una página de pago alojada para las suscripciones
Solicitas a Rapyd que genere una página de pago de suscripción alojada.
Rapyd procesa tu solicitud y envía la respuesta con la URL de redireccionamiento.
Muestras la URL de redireccionamiento al cliente.
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.
Crear página de suscripción alojada
Rapyd recopila la información de pago de la suscripción a través de una página alojada generada. Si un cliente no tiene una tarjeta registrada, puedes dirigirlo a la página de pago de las suscripciones alojadas para recopilar la información de pago de la suscripción. Además, puedes generar varias páginas alojadas y enviarlas a diferentes clientes.
Puedes personalizar el aspecto de la página para que coincida con tu marca y tu experiencia en el sitio web, tal y como se describe en Personalización de la página alojada
Debes completar los siguientes pasos para generar una página de pago de suscripciones alojadas:
Crea un producto (Integración de API)
Crea un plan (Cree un plan de precios para el producto mediante la integración de la API)
Crear un cliente (Integración de API o mediante el portal del cliente)
Genere una página de pago alojada para las suscripciones (integración de API o mediante el portal del cliente)
La página Crear suscripción por hospedado describe los parámetros de la solicitud con mayor detalle.
Parámetro corporal | Necesario | Descripción | Se relaciona con |
|---|---|---|---|
elementos_de_suscripción | sí | Conjunto de artículos de suscripción. Cada artículo contiene un plan (obligatorio) y una cantidad (opcional).
| Objeto de suscripción |
cliente | sí | ID del cliente que paga esta suscripción. Cadena que comienza por cus_ | |
facturación | sí | Determina el método de facturación. Definido en pagar_automáticamente |
Solicitud
// Request URL: GET https://sandboxapi.rapyd.net/v1/checkout/subscription // Message body: { "subscription_items": [ { "plan": "plan_9d7bc847f1ad3fe36f389273f5e22b56", "quantity": 1 } ], "country": "US", "language": "EN", "customer": "cus_49ea9673acfbe53fac114fbf4bd94be3", "coupon": "coupon_da009d56dd6b7fdf4de28af673430a63", "billing": "pay_automatically", "tax_percent": 3, "trial_period_days": 7, "metadata": [{ "my_meta_data_key": "metadata_value" }] }
Texto del botón principal
El merchant_main_button parámetro de la solicitud permite definir el texto del botón principal de la página de suscripción alojada. Esto es para las suscripciones que no tienen versiones de prueba.
Las opciones para el texto del botón son:
Suscríbase
Adquirir
Pagar
Cuando se usa una suscripción con versión de prueba en la página de suscripción alojada, la opción predeterminada de Iniciar la versión de prueba se usa.
Crear suscripción por página alojada describe los campos de la respuesta.
Respuesta
{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "9e7ede34-9c44-494f-b833-c1734afee646" }, "data": { "id": "hp_sub_f477f7b37e66ffef1b4be5becfccea46", "status": "NEW", "cancel_url": "https://www.rapyd.net", "complete_url": "https://www.rapyd.net", "language": "en", "merchant_color": "", "merchant_logo": "", "merchant_website": "https://www.rapyd.net", "merchant_customer_support": {}, "merchant_alias": "rap", "merchant_terms": "", "merchant_privacy_policy": "", "page_expiration": 1701594560, "redirect_url": "https://sandboxcheckout.rapyd.net/subscription?token=hp_sub_f477f7b37e66ffef1b4be5becfccea46", "merchant_main_button": "start_trial", "subscription_items": [ { "id": "", "plan": { "id": "09de6170-d76b-4450-8dcb-7833f5706384", "tiers": [], "token": "plan_9d7bc847f1ad3fe36f389273f5e22b56", "amount": 100, "product": null, "interval": "day", "metadata": { "merchant_defined": true }, "nickname": "hcp", "created_at": 1700384490, "deleted_at": 0, "tiers_mode": "", "usage_type": "licensed", "product_name": "HCP", "product_type": "service", "currency_code": "USD", "product_token": "product_eb45c8152bede037911d5e99ee4bc116", "billing_scheme": "per_unit", "interval_count": 20, "aggregate_usage": "sum", "organization_id": "", "transform_usage": {}, "product_is_active": 1, "trial_period_days": 0, "transform_usage_round": "up", "transform_usage_divide_by": 1 }, "token": "", "created": 0, "deleted": false, "prorate": true, "quantity": 1, "plan_token": "plan_9d7bc847f1ad3fe36f389273f5e22b56", "clear_usage": false, "proration_date": 0 } ], "customer": "cus_49ea9673acfbe53fac114fbf4bd94be3", "customer_payment_methods": [], "bank_redirect_customer_payment_methods": [], "country": "US", "trial_from_plan": false, "trial_period_days": 7, "tax_percent": 3, "billing_cycle_anchor": 0, "billing": "pay_automatically", "cancel_checkout_url": "https://www.rapyd.net", "complete_checkout_url": "https://www.rapyd.net", "payment": { "amount": null, "original_amount": 0, "is_partial": false, "currency_code": "", "country_code": "", "status": "", "description": "", "merchant_reference_id": "", "customer_token": "", "payment_method": "", "payment_method_data": {}, "expiration": 0, "captured": false, "refunded": false, "refunded_amount": 0, "receipt_email": "", "complete_payment_url": "", "error_payment_url": "", "receipt_number": "", "flow_type": "", "address": null, "statement_descriptor": "", "transaction_id": "", "metadata": null, "failure_code": "", "failure_message": "", "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": "", "payment_method_type_category": "", "fx_rate": "", "merchant_requested_currency": null, "merchant_requested_amount": null, "fixed_side": "", "payment_fees": null, "invoice": "", "escrow": null, "group_payment": "", "cancel_reason": null, "initiation_type": "", "mid": "", "next_action": "not_applicable" }, "metadata": [ { "my_meta_data_key": "metadata_value" } ], "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 }, "payment_method_type": "", "coupon": "coupon_da009d56dd6b7fdf4de28af673430a63", } }
Los datos de esta sección muestran:
El identificador de la suscripción es sub_f477f7b37e66ffef1b4be5becfccea46.
El método de pago del cliente se cobrará cada 20 días por las unidades que utilice para el servicio de suscripción.
El identificador del cupón es coupon_da009d56dd6b7fdf4de28af673430a63.
Soporte de cupones para páginas de suscripción alojadas
Se admiten cupones para las páginas de suscripción alojadas. Introduce el parámetro «cupón» en la solicitud de creación de una suscripción por página alojada con el identificador del cupón, empezando por cupón_.
También puedes añadir un cupón pasando el parámetro «cupón» en la solicitud de Crear cliente. Luego, pasas el ID de cliente al crear la página de suscripción alojada.