사용자 자산 조회

이 API는 게임 실행 또는 베팅 시 HighEnd 플랫폼에서 파트너 서버로 호출됩니다.

주요 기능은 사용자의 현재 잔액을 조회하는 것이며, 에이전트는 이를 구현하여 요청에 대한 적절한 응답을 반환해야 합니다.

---

GET {파트너 Callback URL}/balance

Query String Parameter

Name	type	Description
username*	String	이 값은 파트너가 사용자 생성 API 또는 일회성 게임 URL 생성 API를 호출할 때 지정했던 username입니다.

Response

Name	Type	Description
success*	boolean	이 필드는 사용자 잔액 조회 요청이 성공했는지 또는 실패했는지를 나타냅니다.
balance	Number	이 필드는 API 요청을 수신한 시점의 사용자 잔액을 나타냅니다. 응답이 success: true인 경우 반드시 포함되어야 하며, 값은 소수점 6자리까지 지원됩니다.
error	String	이 필드는 응답 실패의 원인을 나타냅니다. 응답이 success: false인 경우 필수적으로 포함되어야 합니다.

응답이 success: false인 경우, HighEnd 플랫폼이 실패 원인을 진단하고 디버깅할 수 있도록 적절한 error 객체를 응답에 포함해야 합니다.

Response example

200 Success

{
    "success": true,
    "balance": 320094.55
}

200 Error