Recursos #

*País/Região de suporte na Europa：

Áustria, Bélgica, Bulgária, Chipre, República Tcheca, Dinamarca, Estônia, Finlândia, França, Alemanha, Grécia, Hungria, Irlanda, Itália, Letônia, Lituânia, Luxemburgo, Malta, Países Baixos, Polônia, Portugal, Romênia, Eslováquia, Espanha, Suécia, Noruega, Liechtenstein, Islândia, Suíça, Mônaco

Método de integração #

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

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_eu à 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": "E298483@Gmail.com"
        }
    },
    "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.