Skip to content

Giro Pay

MH Integration option

Payment Flow

  1. The customer selects giropay as a payment method on the merchant's website.
  2. The merchant sends a payment request to the PaySage.io.
  3. PaySage.io responds with a link to the payment page.
  4. The merchant redirects the customer to the payment page.
  5. The customer completes the payment.
  6. PaySage.io sends a webhook notification with the payment status to the merchant.
  7. The merchant displays the payment status to the customer.

Payment

Info

This integration option supports only `EUR` currency.
Request

Send a payment request with the following additional parameters:

Parameter Type Description
request object
return_url * required
 string URL to return the customer to when the transaction is completed.
ip string The customer's IP address.
method object A section of the payment method information.
type * required
 string giro_pay
user_id * required
 string Unique customer identifier in the merchant's system.
customer object A section of the customer details.
email * required
 string The customer's email address.
country * required
 string (2) The customer's country in the ISO 3166-1 Alpha-2 format. For example, DE.
Request example 
{
  "request": {
    "amount": 500,
    "currency": "EUR",
    "description": "description",
    "test": true,
    "return_url": "https://return.com",          
    "language": "en",
    "customer": {
      "email": "example@example.com",
      "country": "DE"
    },
    "method": {
      "type": "giro_pay",
      "user_id": "fdsaf345"
    }
  }
}
Response

The giro_pay response object will have the parameters copied from the request as well as the form object to build a form where you should redirect the customer to finalize the payment.

Response example 
{
  "transaction": {
    "uid": "be9c355a-d23e-40cf-b992-3a5c92c04002",
    "type": "payment",
    "status": "pending",
    "amount": 500,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-03-14T21:31:44Z",
    "updated_at": "2024-03-14T21:31:45Z",
    "method_type": "giro_pay",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/be9c355a-d23e-40cf-b992-3a5c92c04002/9fa1623bb5de476c165b9f9e58de8cec7518438651af84852b8aee02a3007ba3?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3806,
      "ref_id": "1710451904992",
      "message": "Transaction was initialized",
      "rrn": 33761390
    },
    "giro_pay": {
      "user_id": "fdsaf345",
      "type": "giro_pay"
    },
    "customer": {
      "email": "example@example.com",
      "country": "DE",
      "ip": "null"
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized",
    "test": true,
    "language": "en",
    "billing_address": {
      "email": "example@example.com",
      "country": "DE"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://mh/v1/paymentpage/1298/1710451904992",
      "method": "GET",
      "fields": []
    }
  }
}