O Giropay é um sistema interbancário, introduzido por o Bancos alemães em 2005 como o método de pagamento oficial para serviços bancários on-line. Ele pode ser acessado por mais de 40 milhões de compradores e responde por 16% de todas as transações on-line na Alemanha.

Recursos #

*A giropay garante contratualmente o pagamento por até 6 semanas após a transação inicial.

Método de integração #

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

Há um método de integração para o Giropay

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

Observe que, para esse método de pagamento, você precisa especificar o país em billing_details.address como Alemanha, qual código de país é DE.

Solicitação Criar um PaymentIntent

{
    "amount": 2000,
    "currency" (moeda): "EUR",
    "confirm": true,
    "payment_method_data": {
        "type": "giropay",
        "billing_details": {
            "address" (endereço): {
                "country" (país): "DE"
            },
            "firstName": "",
            "lastName": ""
        }
    },
    "return_url": "https://wooshpay.com"
}

Resposta

{
    "id": "pi_1670644604036186112",
    "object": "payment_intent",
    "created": 1687147687000,
    "livemode": falso,
    "currency": "EUR",
    "amount" (valor): 2000,
    "status": "requires_action",
    "client_secret": "pi_1670644604036186112_secret_9UHXdOLAE1WV7A1UCIjH8nMP",
    "next_action": {
        "type": "redirect_to_url",
        "giropay_handle_redirect": {
            "url": "https://r3.girogate.de/ti/simgiropay?tx=2090827518&rs=33tiT9GdES3vl4zIQ4ShK4Sw3NsvymQj&cs=0981d204f358af0d05ea4aa49a2b678fbe36aa4f13af2624441385921431f7a6"
        }
    },
    "payment_method_types": [
        "giropay"
    ],
    "confirmation_method" (método de confirmação): "automatic",
    "return_url": "https://wooshpay.com",
    "payment_method": "pm_1670644603939717120",
    "capture_method": "automatic"
}

Checkout #

Fluxo de pagamento #

1. O cliente seleciona Giropay na lista de métodos de pagamento disponíveis e clica no botão Pay (Pagar)

2. Os clientes serão redirecionados para a página da Giropay

3. Os clientes selecionam seu banco e aprovam o pagamento por meio do banco on-line

Criar uma seção #

Solicitação Criar uma sessão

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

Resposta

{
    "id": "cs_1680883889586831360",
    "object": "checkout.session",
    "created": 1689588923000,
    "livemode": falso,
    "currency": "EUR",
    "customer": "",
    "mode" (modo): "payment" (pagamento),
    "status": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
    "cancel_url": "www.wooshpay.com",
    "line_items": {
        "object": "list",
        "data": [
            {
                "id": "li_1680883889620385792",
                "object": "item",
                "currency": "EUR",
                "description": "apple",
                "price": {
                    "id": "price_1680883889632968704",
                    "object": "price" (preço),
                    "created": 1689588923000,
                    "livemode": falso,
                    "active": falso,
                    "currency" (moeda): "EUR",
                    "product" (produto): {
                        "id": "prod_1680883889641357312",
                        "object": "product",
                        "created" (criado): 1689588923000,
                        "livemode": falso,
                        "active": falso,
                        "name" (nome): "apple",
                        "updated": 1689588923000
                    },
                    "type" (tipo): "one_time",
                    "unit_amount": 2000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity" (quantidade): 1,
                "amount_subtotal": 2000,
                "amount_total": 2000
            }
        ]
    },
    "payment_intent": "pi_1680883889804935168",
    "payment_method_types": [
        "giropay"
    ],
    "payment_status": "unpaid" (não pago),
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 2000,
    "amount_total": 2000,
    "billing_address_collection": "auto",
    "expires_at": 1689675323250,
    "payment_link": "",
    "client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}

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.

Criar um reembolso #

Crie um reembolso para devolver os fundos ao seu cliente. Você também pode realizar reembolsos parciais, mas nem todos os métodos de pagamento os aceitam. Um reembolso parcial é quando você reembolsa apenas parte do valor original da transação.