9Pago

Con más de millones de usuarios, 9Pay es un monedero digital líder en Vietnam, que satisface las diversas necesidades de pago de los particulares. Se trata de una aplicación "todo en uno" que ofrece una serie de cómodas funciones para el uso diario.

Características #

Tratamiento de divisasVND
Divisas de liquidaciónUSD
Importe mínimo de transacciónTarjeta de débito local mínimo: 10.000 VND
Tarjeta internacional mínimo: 10.000 VND
9Pay Billetera electrónica mínimo: 5.000 VND
Transferencia bancaria mínimo: 10.000 VND
Importe máximo de la transacciónTarjeta de débito local máximo: 200.000.000 VND
Tarjeta internacional máximo : 200.000.000 VND
9Pay Billetera electrónica máximo: 100.000.000 VND
Transferencia bancaria máximo: sin límite
Reembolsos
Reembolsos parciales
Reembolso parcial múltiple
Contracargo

Subproductos #

ProductoDescripción
9Pay Billetera electrónicaDespués de seleccionar 9Pay como método de pago en la caja del comercio, los clientes serán redirigidos a la página de pago de 9pay. Al seleccionar 9Pay E-wallet, aparece un código QR. A continuación, el comprador abre la aplicación 9Pay en su teléfono móvil y escanea el código de barras que aparece en la página del navegador para completar el pago.
Tarjeta de débito localDespués de seleccionar 9Pay como método de pago en la caja del comercio, los clientes serán redirigidos a la página de pago de 9pay. Después de seleccionar la tarjeta de débito local y el nombre del banco local, los clientes rellenan la información de la tarjeta y completan el pago.
Tarjeta internacionalDespués de seleccionar 9Pay como método de pago en la caja del comercio, los clientes serán redirigidos a la página de pago de 9pay. Seleccionar tarjeta internacional como método de pago. Al rellenar los datos de la tarjeta, se completará el pago.
Transferencia bancariaTras seleccionar 9Pay como método de pago en el proceso de compra, los clientes serán redirigidos a la página de pago de 9pay. Al seleccionar Transferencia bancaria, los clientes pueden completar el pago mediante transferencia bancaria.

Método de integración #

Valores de la enumeración del método de pago: 9pago

Existen dos métodos de integración para 9Pay

  1. API directa
  2. Pedido

Directo API #

Flujo de pagos #

  1. Para la integración directa de la API, después de crear la intención de pago mediante OpenAPI, los clientes serán redirigidos a la página de inicio de sesión de 9Pay. Los clientes seleccionan el método de pago
Untitled.png
  1. Por ejemplo, los clientes seleccionan el monedero electrónico 9Pay. A continuación, los clientes escanean el código QR para completar el pago.
Untitled1.png
  1. A continuación, los clientes serán redirigidos a la página que usted haya designado.

Cómo integrar #

Para la integración directa de la API, puede crear una PaymentIntent y obtener la url en un solo paso. La siguiente es la demostración de la creación de la intención de pago:

Crear una PaymentIntent

Un PaymentIntent es un objeto que representa su intención de cobrar el pago de su cliente y realiza un seguimiento del ciclo de vida del proceso de pago. Cree un PaymentIntent en su servidor y especifique el importe a cobrar y una divisa admitida. Si ya dispone de una integración de Payment Intents, añada 9pay a la lista de tipos de métodos de pago.

Solicitar

{
    "importe":10000
    "moneda": "VND",
    "confirmar":true,
    "payment_method_data" : {
        "tipo": "9pay"
    },
    "return_url": "https://swooshtransfer.com/"
}

Respuesta

{
    "id": "pi_1668947502776188928",
    "object": "payment_intent",
    "creado": 1686743067000,
    "livemode": false
    "currency": "VND",
    "importe": 10000,
    "status": "requires_action",
    "client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
    "next_action": {
        "tipo": "9pay_handle_redirect",
        "9pay_handle_redirect": {
            "url": "https://sand-payment.9pay.vn/portal?baseEncode=eyJhbW91bnQiOiIxMDAwMCIsImN1cnJlbmN5IjoiVk5EIiwiZGVzY3JpcHRpb24iOiJkZXNjcmlwdGlvbiIsImludm9pY2Vfbm8iOiJjaF8xNjY4OTQ3NTAyOTAyMDE4MDQ4IiwibWVyY2hhbnRLZXkiOiJQVEpwOXUiLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly9hcGl0ZXN0Lndvb3NocGF5LmNvbS92MS9yZWNlaXZlcy9jMTEvcnVybCIsInRpbWUiOiIxNjg2NzQzMDY2In0=&signature=jhZPpXG1XQDVwnexSSnr0WQap2HpLx0NqeeY2NDj3kQ="
        }
    },
    "payment_method_types": [
        "9pay"
    ],
    "confirmation_method": "automatic",
    "return_url": "https://swooshtransfer.com/",
    "payment_method": "pm_1668947502629388288",
    "capture_method": "automatic"
}

Pedido #

Flujo de pagos #

  1. El cliente selecciona 9Pay de la lista de métodos de pago disponibles y pulsa el botón Pagar.
9078ac1b-6da0-4dd7-8641-03e2206015b3.png
  1. Los clientes serán redirigidos a la página de inicio de sesión de 9Pay
Untitled.png
  1. Por ejemplo, los clientes seleccionan el monedero electrónico 9Pay. A continuación, los clientes escanean el código QR para completar el pago.
Untitled1.png
  1. A continuación, los clientes serán redirigidos a la página que usted haya designado.

Crear una sesión #

Solicitar

{
    "cancel_url": "https://swooshtransfer.com/",
    "mode": "pago",
    "success_url": "https://swooshtransfer.com/",
    "payment_method_types": [
        "9pay"
    ],
    "line_items": [
        {
            "price_data": {
                "moneda": "VND",
                "product": null,
                "unit_amount": 10000,
                "activo": true,
                "metadatos": {
                    "clave1": "valor1",
                    "key2": "valor2"
                },
                "apodo": "manzana",
                "product_data": {
                    "id": null
                    "nombre": "manzana",
                    "activo": true,
                    "descripción": "muy deliciosa",
                    "metadata": {
                        "clave1": "valor1",
                        "key2": "valor2"
                    },
                    "url": "www.baidu.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity": 1
        }
    ]
}

Respuesta

{
    "id": "cs_1668947425479360512",
    "object": "checkout.session",
    "creado": 1686743048000,
    "livemode": false,
    "currency": "VND",
    "cliente": "",
    "mode": "pago",
    "estado": "abierto",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url": "https://swooshtransfer.com/",
    "line_items": {
        "object": "lista",
        "data": [
            {
                "id": "li_1668947425508720640",
                "object": "artículo",
                "moneda": "VND",
                "descripción": "manzana",
                "precio": {
                    "id": "price_1668947425533886464",
                    "object": "precio",
                    "creado": 1686743048000,
                    "livemode": falso,
                    "activo": true
                    "moneda": "VND",
                    "metadatos": {
                        "clave1": "valor1",
                        "key2": "valor2"
                    },
                    "apodo": "manzana",
                    "producto": {
                        "id": "prod_1668947425546469376",
                        "objeto": "producto",
                        "creado": 1686743048000,
                        "livemode": falso,
                        "activo": true,
                        "descripción": "muy delicioso",
                        "metadata": {
                            "clave1": "valor1",
                            "key2": "valor2"
                        },
                        "name": "manzana",
                        "url": "www.baidu.com",
                        "updated": 1686743048000
                    },
                    "type": "one_time",
                    "unit_amount": 10000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity": 1,
                "amount_subtotal": 10000,
                "amount_total": 10000
            }
        ]
    },
    "payment_intent": "pi_1668947425710047232",
    "payment_method_types": [
        "9pay"
    ],
    "payment_status": "unpaid",
    "success_url": "https://swooshtransfer.com/",
    "amount_subtotal": 10000,
    "amount_total": 10000,
    "billing_address_collection": "auto",
    "expires_at": 1686829448437,
    "payment_link": "",
    "client_secret": "pi_1668947425710047232_secret_beZrT7mccYT27tC9ju0RbvlJ"
}

Siguiente paso #

Puede añadir más funciones a su integración en función de sus necesidades

Crear un Webhook #

Escuche los eventos de su cuenta WooshPay para que su integración pueda desencadenar reacciones automáticamente. Crea un webhook que se centre principalmente en enabled_events y url.

Crear una devolución #

Cree un reembolso para devolver los fondos a su cliente. También puede realizar reembolsos parciales, pero no todos los métodos de pago los admiten. Un reembolso parcial consiste en devolver sólo una parte del importe de la transacción original.

Cuáles son sus sentimientos
Updated on agosto 8, 2023