Saiba mais sobre o PromptPay, um serviço de transferência instantânea de fundos popular na Tailândia.

O PromptPay é uma solução de infraestrutura desenvolvida e regulamentada pela autoridade responsável pelas políticas de pagamento, o Bank of Thailand (BoT). Seus roteiros de sistema de pagamento modernizam a infraestrutura de pagamento no país juntamente com os bancos. Para transferir fundos entre bancos, os usuários são identificados por meio de proxies, como número de telefone celular, número de identificação nacional, número de registro corporativo ou número de carteira digital.

Recursos #

Fluxo de pagamento #

Método de integração #

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

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

1. API direta
2. Checkout

Direto API #

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 promptpay à lista de tipos de métodos de pagamento.

Solicitação

{
    "amount":1000,
    "currency": "THB",
    "confirm":true,
    "payment_method_data" : {
        "type": "promptpay"
    },
    "return_url": "https://your.website"
}

Resposta

{
    "id": "pi_1664208234002513920",
    "object": "payment_intent",
    "created": 1685613137000,
    "currency": "THB",
    "amount": 1000,
    "status": "requires_action",
    "livemode": falso,
    "client_secret": "pi_1664208234002513920_secret_tzDL9JipXe0RE3qGTkNVty9j",
    "next_action": {
        "type": "promptpay_handle_redirect",
        "promptpay_handle_redirect": {
            "url": "https://apitest.wooshpay.com/v1/receives/c12/pay/pi_1664208234002513920"
        }
    },
    "payment_method_types": [
        "promptpay"
    ],
    "confirmation_method": "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1664208233880879104",
    "capture_method": "automatic"
}

Checkout #

Criar uma seção #

Solicitação

{
    "cancel_url": "www.wooshpay.com",
    "mode": "payment" (pagamento),
    "success_url": "https://wooshpay.com/",
    "payment_method_types": [
        "promptpay"
    ],
    "line_items": [
        {
            "price_data": {
                "currency" (moeda): "THB",
                "unit_amount": 100,
                "nickname": "apple",
                "product_data": {
                    "name": "apple"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1676158633408200704",
    "object": "checkout.session",
    "created": 1688462334000,
    "livemode": falso,
    "currency" (moeda): "THB",
    "customer": "",
    "mode" (modo): "payment" (pagamento),
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1676158633408200704?key=pk_test_NTE2NzQzMzIzODEyNTI4MTY4OTYxOjEyVWdaRjhhSGpqOFZhRDZvaFRyc1RZbzE2ODgwMjY5MjU5NTk",
    "cancel_url": "www.wooshpay.com",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1676158633437560832",
                "object": "item",
                "currency": "THB",
                "description" (descrição): "apple",
                "price" (preço): {
                    "id": "price_1676158633450143744",
                    "object": "price" (preço),
                    "created": 1688462334000,
                    "livemode": falso,
                    "active": true,
                    "currency" (moeda): "THB",
                    "nickname": "apple",
                    "product" (produto): {
                        "id": "prod_1676158633462726656",
                        "object": "product" (produto),
                        "created" (criado): 1688462334000,
                        "livemode": falso,
                        "active": true,
                        "name" (nome): "apple",
                        "updated" (atualizado): 1688462334000
                    },
                    "type" (tipo): "one_time",
                    "unit_amount": 100,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 100,
                "amount_total": 100
            }
        ]
    },
    "payment_intent": "pi_1676158633626304512",
    "payment_method_types": [
        "promptpay"
    ],
    "payment_status": "unpaid" (não pago),
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 100,
    "amount_total": 100,
    "billing_address_collection": "auto",
    "expires_at": 1688548734385,
    "payment_link": "",
    "client_secret": "pi_1676158633626304512_secret_JbvbX6yCPEBB886Z46Rs5vw8"
}

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.