POST
/
v2.01
/
{ClientId}
/
payins
/
payment-methods
/
giropay
{
    "AuthorId": "6672704",
    "CreditedWalletId": "6672709",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": 0
    },
    "ReturnURL": "https://www.mangopay.com/docs/please-ignore", 
    "Tag": "Created using the Mangopay API Postman collection", 
    "StatementDescriptor": "MGP"
}  


{
    "Id": "wt_c80ffe77-7c19-496f-b0f9-a7fb40eae880",
    "Tag": "Created using the Mangopay API Postman collection",
    "CreationDate": 1706098595,
    "AuthorId": "210513027",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": 0
    },
    "Status": "CREATED",
    "ResultCode": null,
    "ResultMessage": null,
    "ExecutionDate": null,
    "Type": "PAYIN",
    "Nature": "REGULAR",
    "CreditedWalletId": "210514820",
    "CreditedUserId": "210513027",
    "PaymentType": "GIROPAY",
    "ExecutionType": "WEB",
    "ReturnURL": "https://www.mangopay.com/docs/please-ignore?transactionId=wt_c80ffe77-7c19-496f-b0f9-a7fb40eae880",
    "RedirectURL": "https://r3.girogate.de/ti/dumbdummy?tx=140176566852&rs=X1JJW7Y7LCkRnu30mozSUGFCnijKDsfE&cs=eec29dd3a3007f06d65ba32ee55eed9a536fdaae5258398a9cfd9aafe2846ca1",
    "StatementDescriptor": "MGP"
}
Warning – Giropay no longer available after June 30, 2024Giropay’s operator Paydirekt has decided to cease the payment method’s services at the end of June, without providing a direct alternative. This decision by Paydirekt impacts the entire industry and is beyond our control.Effective July 1, 2024: 
  • Pay-ins will fail with the 101101 error
  • Refunds will be possible for one year 
This change affects both the new and legacy integrations.Our team is ready to assist you with your integration of alternatives like Klarna, PayPal, or virtual IBANs for the German market. Please reach out via the Dashboard. 
Note – Timeout after 1 hourThe payment session lasts for 1 hour, at which point the pay-in fails automatically if no action has been taken by the user.
Note – Minimum amountThe minimum accepted amount for Giropay pay-ins is €1.00 (100). 
In Production, pay-ins lower than this amount will fail.

​
Body parameters

​
AuthorId
string
required
The unique identifier of the user at the source of the transaction.
​
CreditedWalletId
string
required
The unique identifier of the credited wallet.
​
DebitedFunds
object
required
Information about the debited funds.
​
Fees
object
required
Information about the fees.
​
ReturnURL
string
required
Max. length: 255 charactersThe URL to which the user is returned after the payment, whether the transaction is successful or not.
​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.
For transactions (pay-in, transfer, payout), you can use this parameter to identify corresponding information regarding the user, transaction, or payment methods on your platform.
​
StatementDescriptor
string
Max. length: 10 characters; only alphanumeric and spacesCustom description to appear on the user’s bank statement along with the platform name. Different banks may show more or less information. See the Customizing bank statement references article for details.
​
ProfilingAttemptReference
string
The unique reference generated for the profiling session, used by the fraud prevention solution to produce recommendations for the transaction using the profiling data.Note: Parameter not returned by the API. Profiling feature available on request – contact Mangopay via the Dashboard for more information.

​
Responses


{
    "Id": "wt_c80ffe77-7c19-496f-b0f9-a7fb40eae880",
    "Tag": "Created using the Mangopay API Postman collection",
    "CreationDate": 1706098595,
    "AuthorId": "210513027",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": 0
    },
    "Status": "CREATED",
    "ResultCode": null,
    "ResultMessage": null,
    "ExecutionDate": null,
    "Type": "PAYIN",
    "Nature": "REGULAR",
    "CreditedWalletId": "210514820",
    "CreditedUserId": "210513027",
    "PaymentType": "GIROPAY",
    "ExecutionType": "WEB",
    "ReturnURL": "https://www.mangopay.com/docs/please-ignore?transactionId=wt_c80ffe77-7c19-496f-b0f9-a7fb40eae880",
    "RedirectURL": "https://r3.girogate.de/ti/dumbdummy?tx=140176566852&rs=X1JJW7Y7LCkRnu30mozSUGFCnijKDsfE&cs=eec29dd3a3007f06d65ba32ee55eed9a536fdaae5258398a9cfd9aafe2846ca1",
    "StatementDescriptor": "MGP"
}  

{
    "AuthorId": "6672704",
    "CreditedWalletId": "6672709",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": 0
    },
    "ReturnURL": "https://www.mangopay.com/docs/please-ignore", 
    "Tag": "Created using the Mangopay API Postman collection", 
    "StatementDescriptor": "MGP"
}