Update card limitSignature required
Call this API to change the transaction limit of your WorldCard.
Structure
A message consists of a header and body. For details, see the following sections.
Request header
Request parameters
assetId String REQUIRED
The unique identifier of a card.
dailyLimitMax Long REQUIRED
The maximum daily transaction limit. The amount is based on the smallest unit of the used currency.
monthlyLimitMax Long REQUIRED
The maximum monthly transaction limit. The amount is based on the smallest unit of the used currency.
perTransactionLimitMax Long REQUIRED
The maximum limit for each transaction. The amount is based on the smallest unit of the used currency.
perCardLimitMax Long CONDITIONAL
The maximum transaction limit for a WorldCard. The amount is based on the smallest unit of the used currency. This limit is cumulative and does not reset.
Note:
- When unspecified, the transaction limit for a WorldCard is removed by default.
- If you wish to set a limit, specify this parameter with the intended value.
env Env REQUIRED
The information of the environment.
Response parameters
result Result REQUIRED
The result of the API call.
requestId String REQUIRED
The unique ID assigned by the partner to identify the status change request.
This parameter is returned only if the value of result.resultStatus is S.
More information:
- Maximum length: 32 characters
status String REQUIRED
The status of the application to change the WorldCard transaction limit.
Valid values are:
SUCCESS: indicates the application is successful.FAIL: indicates the application has failed.
This parameter is returned only if the value of result.resultStatus is S.
Request
Response
Result processing logic
After calling the API, a response is returned. Possible values for result.resultStatus are:
Result status | Description |
| Indicates that the API call succeeded. |
| Indicates that the API call failed. For additional information on the failure, refer to result.resultCode. |
| Indicates that the API call result is unknown. If this status is returned, the Partner may make a query. The querying strategy is as follows:
If no queries succeed, contact our Technical Support Team. |
result.resultCode
| Code | Value | Message | Further action |
|---|---|---|---|
| SUCCESS | S | Success | None |
| SYSTEM_ERROR | F | System error. | Do not retry, and contact our Technical Support Team for more details. |
| PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | Check and verify whether the request fields, including the header fields and body fields, are correct and valid. For details on the fields of each API, see the specific API Structure section. |
| UNKNOWN_EXCEPTION | F | API failed due to unknown reason. | The service might be down, retry later. If the issue persists, contact our Technical Support Team. |
| REPEAT_REQUEST | F | Repeat request | Change the requestId and retry calling this API. |
| CONTRACT_NOT_EXIST | F | The contract check has failed | Ensure the Partner has already signed a contract and the input is correct. |
| USER_NOT_EXIST | F | The user does not exist. | Retry with the correct user information. |
| ASSET_NOT_EXIST | F | Asset not exist | Verify that the asset ID is correct and retry. |
| ASSET_STATUS_ERROR | F | Asset status error | Verify that the asset is in good standing and retry. |
| AMOUNT_EXCEED_MAX_LIMIT | F | The amount exceeds limit, current maximum limit: 1000000 | Please make sure that the value is within the limit and retry. |
| ACCESS_TOKEN_EXPIRED | F | The access token expired. | Refresh the token to get a new access token or contact our Technical Support Team to address it. |
| AUTHORIZATION_NOT_EXIST | F | The authorization does not exist. | Make sure that the input is correct. If the issue persists, contact our Technical Support Team to verify the authorization status. |