Visão geral #
A aceitação de pagamentos por débito direto SEPA em seu site consiste em:
- Criação de um objeto para rastrear um pagamento;
- Coleta de informações sobre o método de pagamento;
- Confirmação de mandato;
- Envio do pagamento ao Stripe para processamento.
O WooshPay usa esse objeto de pagamento, o PaymentIntent, para rastrear e tratar todos os estados do pagamento até que ele seja concluído.
As transações de débito direto SEPA têm um limite de 1.000 euros cada.
Método de integração #
Checkout #
Determinar a compatibilidade #
Para oferecer suporte a pagamentos por débito direto SEPA no Checkout, os preços de todos os itens de linha devem ser expressos em euros (código de moeda eur).
Códigos de país disponíveis | |
---|---|
Países da UE | AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE |
Países do EEE | IS, LI, NO |
Países que têm acordos bilaterais com a UE | AD, SM, MC, VA |
Outros países que oferecem suporte à SEPA (somente para contas denominadas em euros) | PF, TF, GI, GG, IM, JE, BL, PM, CH, GB, WF |
———————– | |
Moedas suportadas | euro |
Moedas de apresentação | euro |
Aceitar um pagamento #
Use este guia para saber como habilitar o Débito Direto SEPA - ele mostra as diferenças entre aceitar um pagamento com cartão e usar o Débito Direto SEPA.
Habilitar o Débito Direto SEPA como método de pagamento
Ao criar uma nova sessão de checkout, você precisa:
- Adicione sepa_debit à lista de payment_method_types.
- Certifique-se de que todos os line_items usem a moeda eur.
Método de integração #
Servidor para servidor #
Criar um PaymentIntent #
Um PaymentIntent é um objeto que representa sua intenção de cobrar o pagamento de um cliente e rastreia o ciclo de vida do processo de pagamento em cada estágio.
Primeiro, crie um PaymentIntent em seu servidor e especifique o valor a ser cobrado e a moeda eur (o Débito Direto SEPA não é compatível com outras moedas).
Se você já tiver uma integração usando a API de intenções de pagamento, adicione sepa_debit à lista de tipos de métodos de pagamento para sua intenção de pagamento.
Solicitação
{
"amount": 2000,
"currency" (moeda): "EUR",
"confirm": true,
"payment_method_options": {
"sepa": {
"iban": "DE12500105170648489890"
}
},
"payment_method_data": {
"type": "sepa",
"billing_details": {
"address" (endereço): {
"country" (país): "DE"
},
"email": "[email protected]",
"name": "John Doe"
}
},
"return_url": "https://wooshpay.com"
}
Teste sua integração #
A Wooshpay fornece números de teste que você pode usar para garantir que sua integração esteja pronta para a produção.
Use os números de teste do SEPA Direct Debit ao testar a integração do Checkout com o SEPA Direct Debit.
IBAN de teste: DE12500105170648489890