Add Payment Method Details

Adds new payment method details for the given account.

Primary payment method details are automatically used in new order creations.

POST /v1/accounts/{account_id}/payment-method-details

Add Payment Method Details

cURL

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"
}
'

201

primary_payment_method

{ "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