v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Card Add-ons

Elevate Per-Transaction Limit

<a href="/card-issuance/v1.6/guide/card-products" style={{display:'inline-block',padding:'2px 10px',borderRadius:'9999px',fontSize:'12px',fontWeight:600,lineHeight:'18px',background:'#EEF2FF',color:'#4338CA',border:'1px solid #C7D2FE',textDecoration:'none'}}>Personal Visa only</a>

Temporarily raise the per-transaction limit on an ACTIVE card without an approval flow. The elevated limit auto-reverts to the card's standard per-transaction limit when the elevation expires; the card's long-term limit settings stay unchanged.

Per-currency caps

Currency	Maximum elevated per-transaction limit
USD / XUSD	80,000
SGD	100,000

Concurrency

A card can hold only one elevation in processing or active state at a time. Submitting another request while one is still in effect returns 400.

Fields managed by the server (do not send in the request body)

Field	Reason
currency	Resolved from the card's currency.
intent	Fixed by the server to an internal enum.
reason	Not accepted.

Asynchronous result

The synchronous response only acknowledges the request and returns order_status: PENDING. The final outcome is delivered via the card.elevate_limit.succeeded or card.elevate_limit.failed webhook. Match the webhook to the request by card_id — a card can only have one elevation in flight at a time.

post/v1/issuing/cards/{id}/elevate_limit

Path parameters

idstring uuid required

Example:b3d9d2d5-4c12-4946-a09d-953e82sed2b0

Universally unique identifier (UUID v4) of a resource.

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-keystring uuid

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Request body

limit_amountnumber required

The new per-transaction limit to apply, denominated in the card's currency. Must be greater than 0, up to two decimal places, and within the per-currency cap (80000 for USD/XUSD, 100000 for SGD).

duration_in_daysinteger

Number of days the elevation remains in effect. When the elevation expires, the per-transaction limit auto-reverts to the card's standard cap.

Example request

{
  "limit_amount": 80000,
  "duration_in_days": 14
}

Response

Elevation request accepted. Listen on the webhook for the final result.

card_idstring required

Unique identifier for the card.

card_order_idstring required

ID of the card order.

order_status'PENDING' required

Always PENDING on a freshly accepted elevation request. Listen on the card.elevate_limit.succeeded or card.elevate_limit.failed webhook for the terminal outcome.

Example response

{
  "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
  "card_order_id": "c0cef051-29c5-4796-b86a-cd5ee34bfad7",
  "order_status": "PENDING"
}