Saiba mais sobre o 9Pay, uma carteira digital popular entre os clientes do Vietnã. #

Com mais de milhões de usuários, a 9Pay é uma carteira digital líder no Vietnã, atendendo às diversas necessidades de pagamento das pessoas. É um aplicativo completo que oferece uma série de recursos convenientes para o uso diário.

Recursos #

Subprodutos #

Método de integração #

Valores de enumeração do método de pagamento: 9pagamento

Há dois métodos de integração para a 9Pay

1. API direta
2. Checkout

Direto API #

Fluxo de pagamento #

1. Para a integração direta da API, depois de criar a intenção de pagamento pela OpenAPI, os clientes serão redirecionados para a página de login da 9Pay. Os clientes selecionam o método de pagamento

2. Por exemplo, os clientes selecionam a carteira eletrônica 9Pay. Em seguida, os clientes digitalizam o código QR para concluir o pagamento.

3. Depois disso, os clientes serão redirecionados para a página que você designou.

Como fazer a integração #

Para a integração direta com a API, você pode criar uma PaymentIntent e obter o URL em apenas uma etapa. Veja a seguir a demonstração da criação da intenção de pagamento:

Criar um PaymentIntent

Um PaymentIntent é um objeto que representa sua intenção de cobrar o pagamento do cliente e rastreia o ciclo de vida do processo de pagamento. Crie um PaymentIntent em seu servidor e especifique o valor a ser cobrado e uma moeda compatível. Se você já tiver uma integração de Payment Intents, adicione a 9pay à lista de tipos de métodos de pagamento.

Solicitação

{
    "amount":10000,
    "currency": "VND",
    "confirm":true,
    "payment_method_data" : {
        "type": "9pay"
    },
    "return_url": "https://swooshtransfer.com/"
}

Resposta

{
    "id": "pi_1668947502776188928",
    "object": "payment_intent",
    "created": 1686743067000,
    "livemode": falso,
    "currency" (moeda): "VND",
    "amount" (valor): 10000,
    "status": "requires_action",
    "client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
    "next_action": {
        "type": "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"
}

Checkout #

Fluxo de pagamento #

1. O cliente seleciona a 9Pay na lista de métodos de pagamento disponíveis e clica no botão Pay (Pagar)

1. Os clientes serão redirecionados para a página de login do 9Pay

1. Por exemplo, os clientes selecionam a carteira eletrônica 9Pay. Em seguida, os clientes digitalizam o código QR para concluir o pagamento.

1. Depois disso, os clientes serão redirecionados para a página que você designou.

Criar uma sessão #

Solicitação

{
    "cancel_url": "https://swooshtransfer.com/",
    "mode": "payment" (pagamento),
    "success_url": "https://swooshtransfer.com/",
    "payment_method_types": [
        "9pay"
    ],
    "line_items": [
        {
            "price_data": {
                "currency" (moeda): "VND",
                "product": nulo,
                "unit_amount": 10000,
                "active": true,
                "metadata": {
                    "key1": "value1",
                    "key2": "value2"
                },
                "nickname": "apple",
                "product_data": {
                    "id": nulo,
                    "name": "apple",
                    "active": true,
                    "description" (descrição): "muito delicioso",
                    "metadata": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "url": "www.baidu.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1668947425479360512",
    "object": "checkout.session",
    "created": 1686743048000,
    "livemode": falso,
    "currency" (moeda): "VND",
    "customer" (cliente): "",
    "mode" (modo): "payment" (pagamento),
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url": "https://swooshtransfer.com/",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1668947425508720640",
                "object": "item",
                "currency": "VND",
                "description" (descrição): "apple",
                "price" (preço): {
                    "id": "price_1668947425533886464",
                    "object": "price" (preço),
                    "created": 1686743048000,
                    "livemode": falso,
                    "active": true,
                    "currency" (moeda): "VND",
                    "metadata": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "nickname": "apple",
                    "product": {
                        "id": "prod_1668947425546469376",
                        "object": "product",
                        "created" (criado): 1686743048000,
                        "livemode": falso,
                        "active": true,
                        "description" (descrição): "muito delicioso",
                        "metadata": {
                            "key1": "value1",
                            "key2": "value2"
                        },
                        "name": "apple",
                        "url": "www.baidu.com",
                        "updated": 1686743048000
                    },
                    "type" (tipo): "one_time",
                    "unit_amount": 10000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 10000,
                "amount_total": 10000
            }
        ]
    },
    "payment_intent": "pi_1668947425710047232",
    "payment_method_types": [
        "9pay"
    ],
    "payment_status": "unpaid" (não pago),
    "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"
}

Próxima etapa #

Você pode adicionar mais recursos à sua integração conforme necessário

Criar um webhook #

Ouça os eventos em sua conta WooshPay para que sua integração possa acionar reações automaticamente. Crie um webhook que se concentre principalmente em enabled_events e url.

Criar um reembolso #

Crie um reembolso para devolver os fundos ao seu cliente. Você também pode realizar reembolsos parciais, mas nem todos os métodos de pagamento os aceitam. Um reembolso parcial é quando você reembolsa apenas parte do valor original da transação.