8.1.1 법정화폐 지급 경로 확보
#간단한 설명: 법정화폐 온라인 결제(충전) 채널 확보
- 요청방법 : POST
- 요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/config/channel/options
- 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json
쿼리 매개변수
| 매개변수 이름 | 유형 | 필수 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|---|
key | string | 예 | 판매자 키 | API키 |
merchantId | string | 예 | 판매자 ID | 이를 얻으려면 운영팀에 문의하거나 판매자 백엔드에 로그인하여 획득하세요 |
currency | string | 예 | 통화 | 법정 통화 기본 CNY |
sign | string | 예 | 서명 | 자세한 내용은 서명 알고리즘을 참조하세요. |
json 샘플 요청
{
"key": "dNNTJZpgFVWlYrVv",
"merchantId": "302992856974",
"currency": "CNY",
"sign": "916a6e145819ee0d4bf1b8ab455583b0"
}
응답 JSON 예시
{
"code": 0,
"success": true,
"message": null,
"data": [
{
"channelCode": "777",
"name": "M支付-支付宝代收",
"currency": "CNY",
"tradeMethod": "BANK",
"level": 7,
"limitType": "RANGE",
"limitPloy": {
"min": 2000,
"max": 100000
},
"fileDto": null,
"feature": {
"featureType": "STABLE",
"rate": 80,
"paymentNeedMinuteMin": 0,
"paymentNeedMinuteMax": 0,
"collectNeedMinuteMin": 0,
"collectNeedMinuteMax": 0
}
},
{
"channelCode": "tencentest9",
"name": "paytest02-支付宝(tencen用,勿改)",
"currency": "CNY",
"tradeMethod": "ALIPAY",
"level": 4,
"limitType": "ARRAY",
"limitPloy": {
"list": ["100", "500", "1000", "2000"]
},
"fileDto": {
"gid": "x1eBfWZjxyGCxfTgm0o9f1EbMA6iHvv7",
"fileUrl": "https://dx-orderbucket20230822.s3.ap-southeast-1.amazonaws.com/test/2024/12/Hvlz4TK4FBSCUaGRmF3WvK6V9zZofTit.jpg",
"previewUrl": "https://dx-orderbucket20230822.s3.ap-southeast-1.amazonaws.com/test/2024/12/preview_Hvlz4TK4FBSCUaGRmF3WvK6V9zZofTit.jpg"
},
"feature": {
"featureType": "UNSTABLE",
"rate": 80,
"paymentNeedMinuteMin": 0,
"paymentNeedMinuteMax": 0,
"collectNeedMinuteMin": 0,
"collectNeedMinuteMax": 0
}
}
]
}
응답 데이터 매개변수 설명
| 매개변수 이름 | 유형 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|
channelCode | string | 채널 코드 | |
name | string | 채널 이름 | |
currency | string | 채널 통화 | |
tradeMethod | enum | 채널 거래 방법 | 은행 은련카드, ALIPAY 알리페이, WECHAT 위챗 |
level | int | 우선순위 | |
limitType | enum | 충전한도 정책 유형 | 범위 범위 |
limitPloy | object | 충전제한 정책 | 예를 들어 재충전은 ["100", "500", "1000", "2000"] |
fileDto | object | 로고 부착 정보 | |
| └ 지드 | string | 첨부파일식별ID | |
| └파일URL | string | 파일 액세스 주소 | |
| └미리보기 URL | string | 파일 미리보기 주소 | |
feature | object | 채널 특성 | |
| └특징 유형 | enum | 채널 기능 유형 | STABLE 안정, UNSTABLE 불안정 |
rate | double | 대략적인 성공률 | |
paymentNeedMinuteMin | int | 최소 출금 가능 시간 범위(분) | |
paymentNeedMinuteMax | int | 최대 출금 가능 시간 범위(분) | |
collectNeedMinuteMin | int | 최소 재충전 시간 범위(분) | |
collectNeedMinuteMax | int | 최대 재충전 시간 범위(분) |