Precheck Create Card
POST
/api/v1/consumer/card-products/10010105/cards/create/precheck
Gateway Contract
Common Errors
| Code | When |
|---|---|
VALIDATION.INVALID_PARAMETER | cardCount is invalid or settings are unsupported/non-customizable for this product |
RESOURCE.NOT_FOUND | card BIN group, product-to-group assignment, or matching-currency wallet not found |
REQUEST.CONFLICT | selected card BIN product is not active |
请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.elaypay.app/api/v1/consumer/card-products/10010105/cards/create/precheck' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm;' \
--header 'X-Workspace-Id;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"cardBinGroupBizId": "CPG_ABCDEF1234567890",
"cardBinProductBizId": "CBP_ABCDEF1234567890",
"cardDisplayName": "Operations Card",
"settings": {
"spendingConstraint": {
"spendingRule": {
"utilizationLimitV2": [
{
"preset": "string",
"limitAmount": {
"amountCents": 0
},
"timezone": "string",
"startDate": "string"
}
],
"transactionSizeLimit": {
"minimum": {
"amountCents": 0
},
"maximum": {
"amountCents": 0
}
}
},
"merchantRule": {
"merchants": [
"string"
],
"restriction": "string"
},
"merchantCategoryRule": {
"merchantCategories": [
"string"
],
"restriction": "string"
},
"merchantCategoryCodeRule": {
"merchantCategoryCodes": [
"string"
],
"restriction": "string"
},
"countryRule": {
"countries": [
"string"
],
"restriction": "string"
}
},
"isSingleUse": true
},
"cardCount": 3
}'响应示例响应示例
{
"version": "string",
"timestamp": 0,
"success": true,
"code": "string",
"message": "string",
"data": {
"allowed": true,
"requestedCount": 3,
"quotaAllowed": true,
"maxTotalCardCount": 100,
"totalCreatedCardCount": 25,
"remainingQuota": 75,
"balanceAllowed": true,
"issuanceFeePerCard": 200,
"totalIssuanceFee": 600,
"walletBalance": 50000,
"balanceAfterIssuance": 49400,
"failureReason": "Insufficient quota"
}
}修改于 2026-07-15 03:51:44