Giropay es un sistema interbancario, introducido por el bancos alemanes en 2005 como método de pago oficial de la banca en línea. A ella acceden más de 40 millones de compradores y representa 16% de todas las transacciones en línea en Alemania.

Características #

*giropay garantiza contractualmente el pago hasta 6 semanas después de la transacción inicial.

Método de integración #

Valores de la enumeración del método de pago: giropay

Existe un método de integración para Giropay

1. API directa
2. Pedido

Directo API #

Cómo integrar #

Para la integración directa de la API, puede crear una PaymentIntent y obtener la url en un solo paso. La siguiente es la demostración de la creación de la intención de pago:

Crear una PaymentIntent

Un PaymentIntent es un objeto que representa su intención de cobrar el pago de su cliente y realiza un seguimiento del ciclo de vida del proceso de pago. Cree un PaymentIntent en su servidor y especifique el importe a cobrar y una divisa admitida. Si ya dispone de una integración de PaymentIntents, añada giropay a la lista de tipos de métodos de pago.

Tenga en cuenta que para este método de pago, debe especificar el país en detalles_facturación.dirección como Alemania, cuyo código de país es DE.

Solicitar Crear una PaymentIntent

{
    "importe": 2000,
    "moneda": "EUR",
    "confirm": true
    "payment_method_data": {
        "tipo": "giropay",
        "billing_details": {
            "address": {
                "country": "DE"
            },
            "firstName": "",
            "lastName": ""
        }
    },
    "return_url": "https://wooshpay.com"
}

Respuesta

{
    "id": "pi_1670644604036186112",
    "object": "payment_intent",
    "creado": 1687147687000,
    "livemode": false
    "currency": "EUR",
    "importe": 2000,
    "status": "requiere_acción",
    "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": "automatic",
    "return_url": "https://wooshpay.com",
    "payment_method": "pm_1670644603939717120",
    "capture_method": "automatic"
}

Pedido #

Flujo de pagos #

1. El cliente selecciona Giropay de la lista de métodos de pago disponibles y pulsa el botón Pagar.

2. Los clientes serán redirigidos a la página de Giropay

3. Los clientes seleccionan su banco y aprueban el pago a través de la banca electrónica

Crear una seesión #

Solicitar Crear una sesión

{
    "cancel_url": "www.wooshpay.com",
    "mode": "pago",
    "success_url": "https://wooshpay.com/",
    "payment_method_types": [
        "giropay"
    ],
    "line_items": [
        {
            "price_data": {
                "moneda": "EUR",
                "producto": null,
                "unit_amount": 2000,
                "datos_producto": {
                    "nombre": "manzana"
                },
                "esquema_facturación": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantity": 1
        }
    ]
}

Respuesta

{
    "id": "cs_1680883889586831360",
    "object": "checkout.session",
    "creado": 1689588923000,
    "livemode": false,
    "currency": "EUR",
    "cliente": "",
    "mode": "pago",
    "estado": "abierto",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg",
    "cancel_url": "www.wooshpay.com",
    "line_items": {
        "object": "lista",
        "data": [
            {
                "id": "li_1680883889620385792",
                "object": "artículo",
                "moneda": "EUR",
                "descripción": "manzana",
                "precio": {
                    "id": "price_1680883889632968704",
                    "object": "precio",
                    "creado": 1689588923000,
                    "livemode": falso,
                    "activo": false
                    "moneda": "EUR",
                    "producto": {
                        "id": "prod_1680883889641357312",
                        "objeto": "producto",
                        "creado": 1689588923000,
                        "livemode": falso,
                        "activo": false
                        "nombre": "manzana",
                        "actualizado": 1689588923000
                    },
                    "type": "one_time",
                    "unit_amount": 2000,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key"
                },
                "quantity": 1,
                "amount_subtotal": 2000,
                "amount_total": 2000
            }
        ]
    },
    "payment_intent": "pi_1680883889804935168",
    "payment_method_types": [
        "giropay"
    ],
    "payment_status": "unpaid",
    "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"
}

Siguiente paso #

Puede añadir más funciones a su integración en función de sus necesidades

Crear un Webhook #

Escuche los eventos de su cuenta WooshPay para que su integración pueda desencadenar reacciones automáticamente. Crea un webhook que se centre principalmente en enabled_events y url.

Crear una devolución #

Cree un reembolso para devolver los fondos a su cliente. También puede realizar reembolsos parciales, pero no todos los métodos de pago los admiten. Un reembolso parcial consiste en devolver sólo una parte del importe de la transacción original.