게임-통화-api-지급-선택

설명

원본 공장의 API 인터페이스를 요청하여 플레이어 캐릭터에 결제를 수행합니다.
이 인터페이스는 SDK 결제, 제3자 결제, 페이지 결제, 보충 결제 등 모든 결제 채널의 결제 작업에 사용됩니다.
기본 매개변수에는: 주문 번호(orderId), 플랫폼 ID(userId), 결제 금액(amount TWD), 다이아몬드 수량(gameCurrency), 서버 CODE(serverCode), 현재 타임스탬프(timestamp), MD5 서명(sign)이 포함됩니다.
기능 도메인 이름은 원본 공장과 당사 제품의 협의에 따라 결정됩니다. sign 서명 안의 KEY 값은 원본 공장에서 제공합니다(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음).

처리 흐름

요청 URL(post 및 get 방식 지원 필요, POST 우선 권장)[기본 application/x-www-form-urlencoded] 도메인 경로(벤더 제공 필요) 예: http://xxx.xxx.com/user/pay 테스트 서버 링크 예:

java

http://xxx.xxx.com/user/pay?orderId=1616548&userId=3258506&gameCurrency=100&serverCode=ld4&timeStamp=1378456412008&roleId=12045897&sign=1faec808b862af2d5a726f993477529b&proItemId=I50&amount=50

요청 매개변수

매개변수 설명
orderId	주문 번호 유일성, 주문 번호 중복 방문은 한 번만 배송 ; 네트워크 이상이나 인터페이스 원인으로 응답이 반환되지 않을 때, 중복 제출 방문이 발생할 수 있으므로, 한 주문 번호는 한 번만 코인을 발행하도록 보장하십시오.	필수
userId	사용자 ID	필수
proItemId	규칙에 따라 합의된 상품 품목 id	필수
gameCurrency	게임 화폐(예: 다이아몬드 수량)	필수
~~amount~~	~~[폐기]금액(플랫폼 화폐)~~ 【폐기됨, 양측 합의 상품 품목 id/서명 검증으로 통일, 상품 품목 id는 백엔드에 구성되어 서버 간 상호작용하며, 프론트엔드 변조를 걱정할 필요 없음 】	필수
serverCode	결제 서버 CODE	필수
timestamp	타임스탬프 [초 단위로 정확함]	필수
roleId	캐릭터 ID	필수
channel	교환 채널: 현재 4가지 종류만(iOS,android,huawei,third)	필수
comefrom	교환 출처: 예(iOS,android,huawei,web,osa) 등; (주의: 구분이 필요하지 않으면 기본적으로 전송하지 않음)	선택
sign	서명, 암호화 규칙 MD5(orderId+userId+proItemId+gameCurrency+serverCode+결제KEY+timestamp) 결제KEY: 양측이 사전에 합의한 기밀 값(영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음)	필수
expandParam	확장 매개변수【투과 매개변수】, 서명 암호화에 참여하지 않음, 게임이 필요할 때만 전송. ; 주의: 특수 기호【json 형식 기호】를 지원하지 않음, json【충돌 발생】을 지원하지 않음, [소스에서 Base64URL로 해결 가능]	선택

반환 결과

반환 결과(표준 JSON 형식)
성공	{"ret":0, "msg": "ok"}	ret:0 수신 성공
실패	{"ret":1001, "msg": "매개변수 오류"}	ret이 0이 아니면 오류, 참고: 오류 코드 설명이 정의된 경우 알려주시기 바랍니다

반환 JSON 필드

매개변수 설명
ret	반환 상태	필수 반환
msg	반환 정보 설명	필수 반환 ; (주의: 반환 msg는 오류 원인을 정확하게 설명하는 것을 권장하며, roleId 오류 시에도 system busy 원인을 사용하는 것을 권장하지 않음)

오류 코드

1001 매개변수 오류 1002 존재하지 않는 사용자 1003 sign 오류 1004 중복 주문 번호( 주의: 이미 게임 코인 발행에 성공한 것으로 확인된 주문 번호라면, 직접 성공 상태를 반환하는 것을 권장합니다) 1008 계정이 비활성화됨 65535 서버 오류