Credit cards

Link a card token with an account

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

post/card/account/link

Request

  • Base URL
    http://<host-url>
  • URL
    http://<host-url>/card/account/link
  • Auth
    HTTP bearer

Headers

unique-request-idstring

Unique identifier of a request.

Request body

account_idinteger required

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

card_external_referencestring

Optional external reference of the card.

card_tokeninteger required

Card token to link to the account.

fixed_limitnumber

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

percentage_limitnumber

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

reset_on_cycleboolean required

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

Response

Card token successfully linked to account

account_idinteger

Credit account identifier linked to the card token.

card_external_referencestring

External reference of the linked card.

card_tokeninteger

Card token linked to the account.

fixed_limitnumber

Configured fixed monetary spending limit for the card.

percentage_limitnumber

Configured percentage of the account credit limit available to the card.

reset_on_cycleboolean

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

Changes

No recorded changes to this operation across all 1 revision of this API.