- 接入指南
- 认证与签名
- 加密与解密
- Webhook 通知
- 错误码与重试
- 关于SDK
- 卡产品组
- 卡产品
- 卡钱包
- 卡钱包划转
- 卡钱包相关字典
- 卡钱包查询
- 卡片交易
- 卡钱包交易
- 卡钱包交易订单
- 卡钱包交易流水
- 卡片
卡产品组详情
POST
/card-products/groups/get
如何阅读开卡配置#
1.
providerType（渠道编码）和 fundingModel（资金形态），选择对应的 preset 结构。2.
preset.settings 是默认控制值；preset.customizable 表示哪些维度允许客户修改，true 为允许，false 为禁止。3.
limitCeilings 返回的周期、金额范围及支持项。金额使用币种最小单位，例如美元 100 表示 1.00 美元。4.
preset 可为 null，不代表所有控制项均可自定义。各渠道配置区别#
| 渠道编码及卡类型 | 配置内容 | 可自定义维度 |
|---|---|---|
| 10010105 | 消费限额、单笔交易上下限、商户名单、国家名单、一次性卡设置 | limits、transaction、merchantRule、countryRule、singleUse；以实际开关及能力上限为准 |
| 10010107 | 空预设 {} | 没有可自定义控制项 |
接入注意#
issuancePresetConfig 已弃用，新接入使用 preset。openCardQuota 表示开卡数量配额，不是消费金额限额。feeCurrency 为 null 时，费用币种以所选卡产品的 cardProductGroupConfig.feeCurrency 为准。请求参数
Header 参数
Body 参数application/json必填
示例
{
"userCardProductGroupBizId": "UCPG_ABCDEF1234567890"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.lampays.com/card-products/groups/get' \
--header 'X-API-VERSION: 2' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
"userCardProductGroupBizId": "UCPG_ABCDEF1234567890"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"version": "string",
"timestamp": 0,
"success": true,
"code": "string",
"message": "string",
"data": {
"bizId": "UCPG_ABCDEF1234567890",
"groupCode": "UCPG12345678",
"groupDescription": "Primary group description",
"lifecycleStatus": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"userFeeConfig": {
"issuanceFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"closureFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"transactionFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"foreignTransactionFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"reversalFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"refundFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"chargebackFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"rechargeFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
},
"withdrawFee": {
"tariffModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"bands": [
{
"bandCode": "string",
"lowerBound": 0,
"upperBound": 0,
"fixedAmount": 0,
"rate": 0,
"priority": 0
}
],
"roundingMode": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"floorAmount": 0,
"ceilingAmount": 0,
"minAmount": 0,
"maxAmount": 0
}
},
"issuancePresetConfig": null,
"preset": null,
"limitCeilings": {
"unit": "MINOR_UNIT",
"maxLimitCount": 3,
"allowedPeriods": [
"DAILY"
],
"periodAmount": {
"property1": {
"min": 200,
"max": 2000000,
"step": 100
},
"property2": {
"min": 200,
"max": 2000000,
"step": 100
}
},
"transactionMax": {
"min": 200,
"max": 2000000,
"step": 100
},
"initialAmount": {
"min": 200,
"max": 2000000,
"step": 100
},
"startDateSupported": true,
"transactionMinSupported": true,
"merchantRuleSupported": true,
"countryRuleSupported": false,
"singleUseSupported": false
},
"openCardQuota": {
"maxTotalCardCount": 0,
"totalCreatedCardCount": 0,
"remainingQuota": 0
},
"createdAt": 1771898400000,
"updatedAt": 1771898700000,
"providerType": 10010105,
"fundingModel": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active"
},
"feeCurrency": {
"code": "ACTIVE",
"value": 35010102,
"label": "Active",
"scale": 2,
"isFiat": true,
"isStablecoin": false
}
}
}修改于 2026-09-19 14:40:04