Bank transfer
Redirect - Bank transfer
Creates a Bank transfer Redirect order.
Parameters
type | string
Specifies the payment flow for the checkout process. Options: direct, redirect, checkout, paymentlink.
order_id | integer / string
The unique identifier from your system for the order. If the values are only numbers the type will be integer, otherwise it will be string.
currency | string
The currency (ISO-4217) you want the customer to pay with.
amount | integer
The amount (in cents) that the customer needs to pay.
gateway | string
The unique gateway_id to immediately direct the customer to the payment method. You retrieve these gateways using a gateway request. Options: BANKTRANS.
description | string
A text which will be shown with the order in MultiSafepay Control. If the customer’s bank supports it this description will also be shown on the customer’s bank statement. Max. 200 characters. HTML is not supported. Use the ‘items’ or ‘shopping_cart’ objects for this.
payment_options | object
notification_url | string
Endpoint where we will send the notifications to notification_url
redirect_url | string
Customer will be redirected to this page after a successful payment. In the event that the transaction is marked with the status uncleared, the customer will also be redirected to the thank-you page of the webshop. The uncleared status will not be passed on to the customer who will experience the payment as successful at all times.
cancel_url | string
Customer will be redirected to this page after a failed payment.
customer | object
locale | string
Displays the correct language and payment methods on the payment page. It also has an influence on sending the set email templates. Use the format ab_CD with ISO 639 language codes and ISO 3166 country codes. Default: en_US.
ip_address | string
The IP address of the customer. “Required” with post payment and credit card payment methods. Due to validation of the customer IP address, we need to receive the actual IP address of the end user within the ip_address field. More info
email | string
The email address where the system can send payment instructions to the customer.
country | string
Customer’s provided country code in ISO 3166-1 format e.g. ‘NL’. This will provide a local bank account to the customer to pay to, where available.
Note: The ip_address parameter is not required, although its use is recommended to help detect fraudulent payments.
Read more about bank transfers on our documentation page.
Direct - Bank transfer
Creates a Bank transfer Direct order.
Parameters
type | string
Specifies the payment flow for the checkout process. Options: direct, redirect, checkout, paymentlink.
order_id | integer / string
The unique identifier from your system for the order. If the values are only numbers the type will be integer, otherwise it will be string.
currency | string
The currency (ISO-4217) you want the customer to pay with.
amount | integer
The amount (in cents) that the customer needs to pay.
gateway | string
The unique gateway_id to immediately direct the customer to the payment method. You retrieve these gateways using a gateway request. Options: BANKTRANS.
description | string
A text which will be shown with the order in MultiSafepay Control. If the customer’s bank supports it this description will also be shown on the customer’s bank statement. Max. 200 characters. HTML is not supported. Use the ‘items’ or ‘shopping_cart’ objects for this.
payment_options | object
notification_url | string
Endpoint where we will send the notifications to notification_url
redirect_url | string
Customer will be redirected to this page after a successful payment. In the event that the transaction is marked with the status uncleared, the customer will also be redirected to the thank-you page of the webshop. The uncleared status will not be passed on to the customer who will experience the payment as successful at all times.
cancel_url | string
Customer will be redirected to this page after a failed payment.
customer | object
locale | string
Displays the correct language and payment methods on the payment page. It also has an influence on sending the set email templates. Use the format ab_CD with ISO 639 language codes and ISO 3166 country codes. Default: en_US.
ip_address | string
The IP address of the customer. “Required” with post payment and credit card payment methods. Due to validation of the customer IP address, we need to receive the actual IP address of the end user within the ip_address field. More info
disable_send_email (optional) | boolean
Set to True if you will send your own bank transfer payment instructions to consumers and do not want MultiSafepay to do this. This value defaults to false.
email | string
The email address where the system can send payment instructions to the customer.
country | string
Customer’s provided country code in ISO 3166-1 format e.g. ‘NL’. This will provide a local bank account to the customer to pay to, where available.
Note: The ip_address parameter is not required, although its use is recommended to help detect fraudulent payments.
In the JSON response for a direct transaction, it is important to send payment instructions to the customer by yourself. Please be aware that all of the parameters can be different for every single transaction. Do not store this information other than for a specific transaction.
Parameters
gateway_info | object
Contains the information for the customer in order to pay for the transaction.
reference | string
A unique number the customer must mention within the bank transfer in order to have the payment recognized by MultiSafepay.
issuer_name | string
The name of our bank to send the money to.
destination_holder_name | string
The account holder name registered to our bank account.
destination_holder_city | string
The city which our bank account is registered in.
destination_holder_country | string
The country which our bank account is registered in.
destination_holder_iban | string
The International Bank Account Number to send the money to.
destination_holder_swift | string
The Bank Identification Code to send the money to.
account_holder_name | string
The customer’s name here if provided in transaction request.
account_holder_city | string
The customer’s city here if provided in transaction request.
account_holder_country | string
The customer’s country here if provided in transaction request.