10.3 캐시채널 주문 조회(수집, 결제)
#간단한 설명: 캐시 채널 수집 및 결제 주문을 조회하는 데 사용되는 인터페이스이며, 주문 번호에 따라 주문 내역을 볼 수 있습니다.
- 요청방법 : POST
- 요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/query/by-third
- 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json
쿼리 매개변수
| 매개변수 이름 | 유형 | 필수 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|---|
orderId | string | 아니요 | 플랫폼 주문번호 | 플랫폼 주문 번호 또는 판매자의 현지 주문 번호 중 하나를 선택하세요 |
localOrderId | string | 아니요 | 판매자의 지역 주문 번호 | 판매자의 현지 주문 번호 2개 중 하나를 선택하거나 당사 플랫폼의 주문 번호 |
key | string | 예 | 판매자 키 | API키 |
sign | string | 예 | 서명 | 자세한 내용은 서명 알고리즘을 참조하세요. |
json 샘플 요청
{
"key": "9yUreYgTRtit39Dy",
"orderId": 274224939517780,
"sign": "07792d2cf97811d3f2e7bd98edb477e3"
}
반환 값
| 매개변수 이름 | 유형 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|
code | int32 | 요청 상태 | 반환 코드, 0은 비즈니스가 성공했음을 의미하고, 그렇지 않으면 다른 오류를 나타냅니다 |
success | boolean | 성공상태 | 호환성 기록에 사용되는 코드=0과 일치하는 성공 식별 |
message | string | 설명 | 오류 메시지. 오류가 있는 경우 오류 메시지가 반환됩니다. |
data | json | 데이터 반환 | 자세한 내용은 아래 매개변수를 참조하세요. |
예로 돌아가기
{
"code": 0,
"success": true,
"message": null,
"data": {
"merchantId": 302992856974,
"merchantUserId": "conan",
"orderId": "477564506808517",
"localOrderId": "conantest9913279",
"type": "PAYMENT",
"status": "SUCCESS",
"currency": "CNY",
"paidAmount": "100",
"amount": "100",
"isReissue": false,
"notifyTime": 1772789295567,
"orderCreateTime": 1772789258844
}
}
데이터 매개변수 설명
| 매개변수 이름 | 유형 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|
merchantId | int64 | 판매자 ID | |
merchantUserId | string | 판매자 사용자 ID | 주문 매개변수 localUserId에 해당하는 값 |
orderId | string | 주문번호 | 우리 플랫폼 주문 번호 |
localOrderId | string | 판매자의 지역 주문 번호 | 판매자의 현지 플랫폼 주문 번호(주문 매개변수 localOrderId의 값에 해당) |
type | enum | 주문 유형 | PAYMENT:支付订单 | WITHDRAW:提款订单 |
status | enum | 주문현황 | PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败 |
currency | string | 통화 주문 | |
paidAmount | number | 주문미수금 및 결제금액 | |
amount | number | 주문금액 | |
isReissue | boolean | 재발행 여부 | |
notifyTime | int64 | 알림 타임스탬프 | 밀리초 |
orderCreateTime | int64 | 주문 생성 타임스탬프 | 밀리초 |