Bank Transfer

Bank Transfer is a way of paying for a product or service by means of transferring money from the consumer's bank account by using a particular reference in the description.

The destination account number to be used for the transfer is given in the API response, and will also be shown on the redirect URL page when it is opened.

You just have to supply the Generic transaction information, everything else is handled by the CURO Payments system.

Bank Transfer Payment

Bank Transfer has no specific arguments.

Entry point: /rest/v1/curo/payment/banktransfer/

REST request elements

See the Bank Transfer request parameters in the API reference.

Field name	Type Length	Required	Description
`[request]`	container	required	General container for this resource. Includes the generic request items.
`[consumer]`	container	required	Consumer information for this transaction (See the generic Consumer and Shipping elements for this transaction.)
`[cartitems]`	container	required	The cart items of the webshop order. (See the generic CartItems elements.)
`recurring`	boolean 1	optional	Indicate this as a master/mandate transaction for recurring payments (using Direct Debit). Supported values: `false` `true`

REST response elements

Field name	Type Length	Description
`[payment]`	container	General container for this resource.
`action`	string ≤ 12	The default action that should be undertaken (redirect).
`external`	boolean 1	Indicates, if TRUE, that the url is to an external website.
`url`	string ≤ 255	Complete issuer URL to which the consumer must be redirected for authentication. The `url` will always contain a link to the default CURO Bank Transfer page on the gateway, where a summary of the transaction is given. Consumers will also have the option to request an e-mail containing the payment instructions. You can use this URL or present the information to the consumer on your own system.
`testmode`	integer 1	Whether the transaction is in test mode (0 or 1).
`transaction_id`	string ≤ 12	Newly created transaction ID.
`[pmdata]`	container	Sub container for payment method specific data.
`recipient_name`	string ≤ 64	Creditor Name as it will appear on the debtor's bank statement. default `Escrow CURO Payments`.
`recipient_iban`	string ≤ 18	Creditor IBAN number that will collect the money. default `NL94INGB0674528859` (an alternative account from the default `NL41INGB0687547407` which is sometimes blocked by banks because it is also used for SEPA Direct Debits).
`recipient_bic`	string ≤ 10	Creditor BIC number. default `INGBNL2A`.
`recipient_extra`	string ≤ 255	Extra information about the recipient.
`pt_type`	string ≤ 12	Type of the bank transfer.
`nn_id`	string ≤ 12	CURO transaction id.
`amount`	integer ≤ 10	Amount to be collected in cents.
`currency_id`	string 3	Currency of the transaction. Always `EUR`.
`reference`	string ≤ 9	Reference the consumer must include in the transfer. It is your responsibility to communicate this clearly to the consumer!
`status`	integer ≤ 9	Id of the status of the bank transfer.
`description`	string ≤ 128	The description given for this transaction.

Bank Transfer Refund

See the generic Refund information and request elements.

Bank Transfer Recurring

When the initial Bank Transfer transaction was registered with the option recurring enabled, subsequent recurring payments can be created using the account information available.

Recurring payments for Bank Transfer are processed via SEPA Direct Debit (SDD). See the generic Recurring (SDD) information and request elements.