Buy Card Cap

Endpoint:

Method: POST
Type: RAW
URL: {{API_BASE_URL}}/cards/buy-card-cap

Request Parameter

Parameter Required Type Description
count Y int Number of Card Caps to purchase. Must be a positive integer. This is the number of Card Caps, not the number of cards.
{
    "count": 7
}

Notes

  • Uses the existing Open API authentication and IP whitelist. No additional Card Cap permission is required.
  • The price uses the Demander's current Card Cap fee. The first-deposit requirement, daily purchase limit and total purchase limit still apply. Coupons are not used.
  • Payment uses the ordinary wallet first, then the spendable shared wallet balance for any shortfall. Shared wallet guarantee funds cannot be used. If the combined spendable balance is insufficient, the purchase fails and no deduction is retained.
  • This endpoint only purchases Card Caps. To issue cards, call /cards/apply after purchasing enough Card Caps. /cards/apply does not purchase Card Caps automatically.

Response

HTTP Status Description
201 Purchase succeeded. The response body is empty.
422 count is missing, is not an integer, or is less than 1.
403 A purchase requirement is not met, such as insufficient wallet funds, an incomplete first deposit or a purchase limit. The reason is returned in message.