Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
payment-method-details
Add Payment Method Details
curl --request POST \
  --url https://sandbox.api.rime.finance/v1/accounts/{account_id}/payment-method-details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "sepa",
  "iban": "DE12345678901234567890",
  "account_holder_name": "Max Mustermann"
}'
{
  "id": "789e0123-e89b-12d3-a456-426614174002",
  "account_id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "sepa",
  "iban": "DE89370400440532013000",
  "account_holder_name": "Max Mustermann",
  "is_primary": true
}

Authorizations

​
Authorization
string
header
required

Bearer access token. Provide as a Authorization: Bearer <token> header.

Path Parameters

​
account_id
string<uuid>
required

Body

application/json
​
type
enum<string>
required

Type of the payment method. Currently, only SEPA transfers are supported.

Available options:
sepa
​
iban
string
required

IBAN of the bank account for SEPA transfers.

Example:

"DE12345678901234567890"

​
account_holder_name
string
required

Name of the bank account holder for SEPA transfers.

Applies to SEPA transfer methods only.

Example:

"Max Mustermann"

​
is_primary
boolean

Whether this is the primary/default resource for the account. Only one resource per account can be primary.

Example:

true

Response

201 - application/json

Payment method details created successfully

​
id
string<uuid>

Unique identifier for the resource.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
type
enum<string>

Type of the payment method. Currently, only SEPA transfers are supported.

Available options:
sepa
​
iban
string

IBAN of the bank account for SEPA transfers.

Example:

"DE12345678901234567890"

​
account_holder_name
string

Name of the bank account holder for SEPA transfers.

Applies to SEPA transfer methods only.

Example:

"Max Mustermann"

​
is_primary
boolean

Whether this is the primary/default resource for the account. Only one resource per account can be primary.

Example:

true

⌘I