Link a card token with an account

post

http://<host-url>/card/account/link

Links an existing card token to an existing credit account in Banking.Live and PayCredit, and configures the card spending limit. Provide either fixed_limit or percentage_limit, but not both.

Body Params

Request for linking an existing card token to a credit account and configuring its spending limit. Provide either a fixed monetary limit or a percentage limit, but not both.

account_id

int32

required

Credit account identifier to which the existing card token will be linked.

card_external_reference

string

Optional external reference of the card.

card_token

int64

required

Card token to link to the account.

fixed_limit

number

Fixed monetary spending limit for the card. Provide this or percentage_limit, but not both.

percentage_limit

number

≤ 100

Percentage of the account credit limit available to the card. Provide this or fixed_limit, but not both.

reset_on_cycle

boolean

required

Whether the card limit is reset automatically at the start of each statement cycle.

Headers

unique-request-id

string

Unique identifier of a request.

Responses

400

Validation error/Bad Request

500

Server error

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Card token successfully linked to account