Conozca 9Pay, un monedero digital muy popular entre los clientes de Vietnam. #

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 #

Subproductos #

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

2. Por ejemplo, los clientes seleccionan el monedero electrónico 9Pay. A continuación, los clientes escanean el código QR para completar el pago.

3. 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.

1. Los clientes serán redirigidos a la página de inicio de sesión de 9Pay

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.

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.