Recursos #
| País/Região de suporte | Europa |
|---|---|
| moeda de processamento | EUR |
| moeda de liquidação | EUR |
| reembolso | ❌ |
| reembolso parcial | ❌ |
| reembolso parcial múltiplo | ❌ |
| estorno | ❌ |
*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
- API direta
- Checkout
Direto API #
Fluxo de pagamento #
- 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
- 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:
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": "[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 #
- O cliente seleciona a transferência bancária na lista de métodos de pagamento disponíveis e preenche as informações de pagamento
- Os clientes enviam dinheiro para uma conta bancária local
- 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.
