Bank Transfer

MY Integration option

Bank transfer flow

The customer initiates a payment.
The merchant sends a payment request to Overpay.
Overpay sends a response with the form object containing action parameter with a link to the payment page.
The merchant redirects the customer to the URL specified in the form.action field from Overpay response.
The customer selects the bank on the payment page and makes a payment.
Once the payment is completed, the customer is redirected to the page specified in return_url in the payment request.
Overpay sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from Overpay with the status query.
The merchant displays the payment status to the customer.

Payment

Request

Send a payment request with the following parameters:

Parameter	Type	Description
request	object
amount required	bigInteger	A transaction amount in minimal currency units, for example, €32.45 must be sent as 3245.
currency required	string	A transaction currency in the ISO-4217 alpha-3 code format. Must be `EUR` or `GBP`.
description required	string(255)	A short description of the order.
notification_url required	string	A URL to get webhook notifications.
return_url required	string	A URL to return the customer to when a transaction is completed.
method	object	A section of the payment method information.
type required	string	`bank_transfer`

Request example

{
    "request": {
        "amount": 20000,
        "currency": "EUR",
        "description": "description",
        "test": false,
        "return_url": "https://your_return_url.com",
        "notification_url": "https://your_notification_url.com",
        "method": {
            "type": "bank_transfer"
        }
    }
}

Response

The response section will have parameters copied from a request. Additionally, you'll get the form object with a URL to the payment page. Redirect the customer to the URL specified in form.action.

Response example

{
    "transaction": {
        "uid": "e567af49-da3b-463d-bc73-2514cf353564",
        "type": "payment",
        "status": "pending",
        "amount": 20000,
        "currency": "EUR",
        "description": "description",
        "created_at": "2023-10-06T14:12:36Z",
        "updated_at": "2023-10-06T14:12:36Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.overpay.io/customer/transactions/21324-1544a58bfe/c3204e3e0df0bc30d675946b36e061091e19cb5c6e889d8e7ab1508666ff6ff5?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 3288,
            "ref_id": "tx_AOvyOzQ8x11HN40u1Gt0rkFn",
            "message": "Transaction was initialized"
        },
        "bank_transfer": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "message": "Transaction was initialized",
        "test": false,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "https://my-integration-option.com/transactions/tx_AOvyOzQ8x11HN98u1Gt0rkFn",
            "method": "GET",
            "fields": []
        }
    }
}

Payment status query

Request

If needed, send a status query request to get the current transaction status.

Response

The response contains the transaction status, a section of the payment method as well as other details related to the transaction according to the description of a transaction status query.