GuidesAPI ReferenceChangelog
Log In
Changelog
Back to All

2026-03-20

3 months ago by marshall

Card Issuing

Add usage_type, auto_cancel_trigger, and expiry_at to Create Card

  • Introduces support for one-time-use cards by adding three optional fields to the Create Card request body.
  • Affected Endpoints:
    • Create Card (request only)
  • Changes:
    • Added optional field usage_type (enum: NORMAL, ONE_TIME; default: NORMAL). When omitted, the card behaves as a standard reusable card.
    • Added optional field auto_cancel_trigger (enum: ON_AUTH, ON_CAPTURE). Required when usage_type is ONE_TIME. Defines the transaction event that triggers automatic card cancellation: ON_AUTH cancels the card immediately after the first authorization is approved; ON_CAPTURE cancels the card after the first transaction's capture (settlement) succeeds.
    • Added optional field expiry_at (date-time string with timezone offset, e.g. 2026-03-19T18:46:43+08:00). If the card has not been cancelled by a first-transaction event before this datetime, it is automatically cancelled and any unused balance is released.

Banking

Add X-Request-Id header to Create Virtual Account

  • Introduces an optional X-Request-Id request header to Create Virtual Account, allowing callers to pass a custom identifier that is echoed back in the associated webhook event.
  • Affected Endpoints:
    • Create Virtual Account
    • webhook: virtual.account.*
  • Changes:
    • Added optional request header X-Request-Id (string, max 64 characters).
    • If provided, the value is returned in the associated webhook event as request_id.

Account Center

Add four required fields to individual_info in Create SubAccount

  • Four new required fields are added to the individual_info object for individual account creation. Requests missing any of these fields will return a validation error after the effective date.
  • Affected Endpoints:
    • Create SubAccount (request only)
  • Changes:
    • Added required field individual_info.employment_status — employment status of the individual.
    • Added required field individual_info.industry — industry the individual works in.
    • Added required field individual_info.job_title — job title of the individual.
    • Added required field individual_info.company_name — name of the company the individual works for.
  • Effective date: 2026-03-19