Get stored bank account by bank account reference

Retrieve a list of bank accounts stored for a specific bank account reference. Currently, the service stores one bank account per buyer. Thus, the returned list contains max. one bank account.

SecurityBearer Authentication
Request
path Parameters
partner_profile_id
required
integer <int32>

partner profile id provided by Ratepay.

Example: MYSHOP_PR_DE
shop_buyer_id
required
string

unique id assigned to the buyer by the merchant

Example: customer_1
bank_account_reference
required
string

the identifier of the bank account

Example: 226e7a20-5e1e-4f23-a56c-c8a851b190e7
header Parameters
Authorization
required
string

For each request, a valid access token must be provided in the Authorization header. See Authentication API for obtaining a valid token.

Content-Type
required
string
Example: application/json
Request Body schema: application/json
Schema not provided
Responses
200

Successfully returned requested data

401

default response

404

Unknown merchant consumer id

405

Method not allowed

406

Data format not supported (JSON only)

413

Request entity too large

500

Internal server error. Try again later.

get/partners/{partner_profile_id}/shop-buyers/{shop_buyer_id}/bank-accounts/{bank_account_reference}
Request samples
Response samples
application/json
{
  • "bank_account_reference": "8e3412b0-a334-4d0a-b132-7ab996d769ef",
  • "owner": "Jane Doe",
  • "iban": "DE07 1234 1234 1234 1234 12",
  • "bic": "MARKDEFFXXX"
}