Recursos #

Método de integração #

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

Há dois métodos de integração para transferência bancária

1. API direta
2. Checkout

Direto API #

Fluxo de pagamento #

1. Para integração direta com a API, após criar a intenção de pagamento pela OpenAPI, os clientes serão redirecionados para a página de transferência bancária

2. Depois de concluir as transferências bancárias locais e clicar em "I've completed payment" (Concluí o pagamento), os clientes verão "payment is being processed" (o pagamento está sendo processado) e serão redirecionados para return_url

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

Crie um PaymentIntent em seu servidor e especifique o valor a ser coletado e uma moeda compatível.

No caso de transferência bancária, notadamente, você também precisa coletar o nome, país e e-mail em payment_method_data.billing_details.

Se você tiver uma integração existente com o Payment Intents, adicione bank_transfer_uk à lista de tipos de métodos de pagamento.

Solicitação

{
    "amount":1000,
    "currency": "GBP",
    "confirm":true,
    "payment_method_data" : {
        "type": "bank_transfer_eu",
        "billing_details":{
            "address": {
                "line1": "XX mansão",
                "line2": "XX Town" (Cidade XX),
                "city" (cidade): "city",
                "state" (estado): "California",
                "country": "GB",
                "postal_code": "55555"

            },
            "name": "Tom Elis",
            "email": "[email protected]"
        }
    },
    "quantity" (quantidade): 2,
    "merchant_user_id": "123456",
    "merchant_order_id": "Order112344343",
    "return_url": "https://your.website"
}

resposta

{
    "id": "pi_1661558941487726592",
    "object": "payment_intent",
    "created": 1684981497000,
    "currency": "GBP",
    "amount": 1000,
    "status": "requires_action",
    "description" (descrição): "descrição do produto",
    "livemode": falso,
    "quantity" (quantidade): 2,
    "merchant_user_id": "123456",
    "merchant_order_id": "Order112344343",
    "client_secret": "pi_1661558941487726592_secret_g4Xl2kP98fwFD5x4HSVyK0Rm",
    "next_action": {
        "type": "bank_transfer_uk_handle_redirect",
        "bank_transfer_uk_handle_redirect": {
            "url": "https://pay-sandbox.tazapay.com/marketplace/paymentdetails/8t0-UMIIGKyeiECODNFV6ldbGjpumbMOsbqpmuw7sg8NXjQ_B_YxmEXSnr_nHAeZ"
        }
    },
    "payment_method_types": [
        "bank_transfer_uk",
        "bank_transfer_eu",

    ],
    "confirmation_method": "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1661558941370286080",
    "capture_method": "automatic"
}

Checkout #

Fluxo de pagamento #

1. O cliente seleciona a transferência bancária na lista de métodos de pagamento disponíveis e preenche as informações de pagamento

2. Os clientes enviam dinheiro para uma conta bancária local

3. Depois de fazer transferências bancárias locais e clicar em "I've completed payment" (Concluí o pagamento), a página mostrará aos clientes que o pagamento está sendo processado e, em seguida, será redirecionada para return_url

Criar uma sessão #

Solicitação

{
    "cancel_url": "www.wooshpay.com",
    "mode": "payment" (pagamento),
    "success_url": "https://wooshpay.com/",
    "payment_method_types": [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "line_items": [
        {
            "price_data": {
                "currency" (moeda): "EUR",
                "product": nulo,
                "unit_amount": 100000,
                "active": true,
                "metadata": {
                    "key1": "value1",
                    "key2": "value2"
                },
                "nickname": "apple",
                "product_data": {
                    "id": nulo,
                    "name": "apple",
                    "active": true,
                    "description" (descrição): "yummy yummy",
                    "url": "www.wooshpay.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity" (quantidade): 1
        }
    ]
}

Resposta

{
    "id": "cs_1661288382405279744",
    "object": "checkout.session",
    "created": 1684916990000,
    "currency": "EUR",
    "customer": "",
    "mode": "payment" (pagamento),
    "livemode": falso,
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1661288382405279744?key=pk_test_NTE2NTc5NDIzMjU1MzM0Nzg5MTMxOjMzb1M2aUVkNkNvalZPRE1nTW5ITDhYcDE2ODQxMTkyMjgzMTQ",
    "cancel_url": "www.wooshpay.com",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1661288382443028480",
                "object": "item",
                "currency": "EUR",
                "description": "apple",
                "price": {
                    "id": "price_1661288382476582912",
                    "object": "price" (preço),
                    "created": 1684916990000,
                    "active": true,
                    "currency": "EUR",
                    "metadata": {
                        "key1": "value1",
                        "key2": "value2"
                    },
                    "nickname": "apple",
                    "product": {
                        "id": "prod_1661288382493360128",
                        "object": "product" (produto),
                        "created" (criado): 1684916990000,
                        "active": true,
                        "description" (descrição): "yummy yummy",
                        "name" (nome): "apple",
                        "livemode": falso,
                        "url": "www.wooshpay.com",
                        "updated": 1684916990000
                    },
                    "type" (tipo): "one_time",
                    "livemode": falso,
                    "unit_amount": 100000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 100000,
                "amount_total": 100000
            }
        ]
    },
    "payment_intent": "pi_1661288382682103808",
    "payment_method_types": [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "payment_status": "unpaid" (não pago),
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 100000,
    "amount_total": 100000,
    "billing_address_collection": "auto",
    "expires_at": 1685003390272,
    "payment_link": "",
    "client_secret": "pi_1661288382682103808_secret_VNK78femqxwsDZbKCRRKvQHR"
}

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.