Evolution gaming API

개요

Evolution Gaming API는 기존 플레이어의 정보를 Evolution Live Casino에서 사용할 수있는 인터페이스를 제공합니다.

로그인된 플레이어로 게임세션을 만들어 Evolution Live Casino에 입장시키고, 플레이어의 보유머니을 파트너사의 보유머니와 연동시킵니다.

단어

Evolution gaming : 게임을 진행하고 유저가 게임을 플레이하는 곳을 의미합니다.
파트너(사) : 저희와 계약한 파트너를 의미합니다.

흐름

유저가 입장을 할 때 API서버로부터 게임세션을 발급받아 유저를 해당 게임세션으로 리다이렉트 시킵니다. ( 게임 세션 발급 )

유저가 Evolution gaming 에 입장한 후, Evolution gaming 안에서 베팅한 금액과 게임의 결과를 <파트너가 정한 경로>들을 통해 받아보실 수 있습니다. ( 보유머니 연동 )

호출의 기본 사항

지원 HTTP 메소드 : POST
HTTP 콘텐츠 포맷 : JSON

HTTP 코드

표준 RFC 2616 HTTP 응답 코드를 사용하여 API 요청의 성공 또는 실패를 나타냅니다.

2XX : 성공을 의미합니다.
4XX : HTTP요청에 문제가 있음을 의미합니다.
5XX : Evolution의 서버에 문제가 있음을 의미합니다.

게임 세션 발급 ( 입장 )

개요

Evolution gaming 서버에 접속하기 위하여 게임 세션을 발급받고 유저를 Evolution gaming에 입장시킵니다.

사용법

개별통보된 API 주소로 게임세션 요청을 보내면 API 서버에서 게임세션을 응답합니다.

발급된 게임세션주소로 유저를 redirect 시켜 Evolution gaming에 입장시킵니다.

API 주소

보안상 게임세션요청을 받는 API주소는 개별통지됩니다.

게임세션 요청 ( request )

Evolution gaming API 서버측으로 게임세션을 요청합니다.

요청 파라미터

이름	데이터 타입	설명
uuid	string	고유한 요청아이디입니다. 매 요청의 아이디는 고유해야됩니다. (uuid4형식)
player	object	플레이어의 정보가 담겨있습니다.
player.id	string	플레이어의 아이디입니다.
player.nickname	string	플레이어의 닉네임입니다.
player.session	object	플레이어의 세션정보들이 담겨있습니다.
player.session.id	string	파트너에서 정해준 세션의 아이디입니다.
player.session.ip	string	플레이어의 아이피입니다.

예시

METHOD

POST

URL

https://<API주소>/api/session?MEMB_ID=<파트너아이디>&HASH=<토큰>

HEADER

Content-Type: application/json

BODY


{
	"uuid": "<uuid4 형식의 고유 아이디>",
	"player": {
		"id": "<유저의 아이디>",
		"nickname": "<유저의 닉네임>",
		"session" {
			"id": "<세션 아이디>",
			"ip": "<유저 클라이언트의 아이피>"
		}
	}
}

게임세션 응답 ( response ) - 성공

Evolution gaming API 서버측에서 응답한 게임세션의 성공 예시입니다.

entry 값을 이용하시면 됩니다.

응답 파라미터

이름	데이터 타입	설명
entry	string	플레이어 리다이렉션에 사용되는 URL입니다.
entryEmbedded	string	플레이어 리다이렉션에 사용되는 URL입니다.

BODY 예시


{
	"entry": "https://example.com/entry?params=...&JSESSIONID=...",
	"entryEmbedded": "https://example.com/entry?params=...&JSESSIONID=...&embedded"
}

게임세션 응답 ( response ) - 실패

Evolution gaming API 서버측에서 응답한 게임세션의 실패 예시입니다.

실패한경우 Evolution gaming서버는 'HTTP status 4XX' 또는 'HTTP status 5XX' 그리고 아래와 같은 응답을 보냅니다.

BODY 예시


{
	"errors": [{
		"code": "G.0",
		"message": "Could not authenticate, please review sent data and try again. If problem persists, contact customer support "
	}]
}

에러코드

오류 코드는 다음 범주로 분류됩니다.

* G - 일반 오류
* V - 입력 매개변수의 유효성 검사 실패

코드	에러문구	설명
G.0	Could not authenticate, please review sent data and try again. If problem persists, contact customer support	지속적으로 발생하는 경우 시스템 오류를 재 시도해야하며 Evolution에보고해야합니다.
G.1	Unknown casino $casinoKey	$ casinoKey는 Evolution에서 제공합니다.
G.2	Provided $apiToken for casino $casinoKey is incorrect	$ apiToken은 Evolution에서 제공합니다.
G.3	Player session creation is not configured for casino $casinoKey	Evolution 쪽에서 $ apiToken이 구성되지 않았습니다.
G.4	Unable to issue token	지속적으로 발생하는 경우 시스템 오류를 재 시도해야하며 Evolution에보고해야합니다.
G.5	Unable to authenticate user
G.6	Unable to create user
G.7	Unable to save player data
G.8	Unable to authenticate user due to: $status	클라이언트 시스템이 유효하지 않은 $ status를 반환했습니다.
G.9	Clients IP address have been rejected	Evolution 클라이언트 IP 주소 화이트리스트가 잘못되었습니다.

코드	에러문구	설명
V.1	'player.update' is a boolean and accepts only true/false	player.update 는 boolean 이여야됩니다.
V.2	'firstName' length must be at least 1 character long	firstName은 1글자보다 길어야됩니다.
V.3	'firstName' length must be no more than 50 characters	firstName은 50글자보다 길면 안됩니다.
V.4	'lastName' length must be at least 1 character long	lastName은 1글자보다 길어야됩니다.
V.5	'lastName' length must be no more than 50 characters	lastName은 50글자보다 길면 안됩니다.
V.6	'nickname' length must be at least 2 characters long	nickname은 2글자보다 길어야됩니다.
V.7	'nickname' length must be no more than 35 characters	nickname은 35글자보다 길면 안됩니다.
V.8	'player.session' is missing	player.session 이 없습니다.
V.9	'player.session.ip' is not correct. Should be 0-255.0-255.0-255.0-255	player.session.ip 가 아이피형식에 올바르지 않습니다.
V.10	'player.session.id' is empty or missing	player.session.id 가 비어있거나 없습니다.
V.11	'player.country' is missing	player.country 가 없습니다.
V.12	'player.currency' is missing	player.currency 가 없습니다.
V.13	'player.language' is missing	player.language 가 없습니다.
V.16	uuid can't be empty	uuid는 비어있으면 안됩니다.
V.17	'player' is empty or missing	player 가 비어있거나 없습니다.
V.18	'config' is empty or missing	config 가 비어있거나 없습니다.
V.19	'config.brand' is missing or empty	config.brand가 비어있거나 없습니다.
V.20	'config.channel' is missing or empty	config.channel 이 비어있거나 없습니다.
V.21	'config.brand.id' is empty	config.brand.id 가 비어있습니다.
V.22	'config.brand.id' too long	config.brand.id 가 너무 깁니다.
V.23	'config.brand.skin' is empty	config.brand.skin 이 비어있습니다.
V.24	'config.brand.skin' too long	config.brand.skin 이 너무 깁니다.
V.25	'config.game.type' or 'config.game.category' must be defined	config.game.type 또는 config.game.category 는 반드시 정의되었어야됩니다.
V.26	'config.game.table.id' is missing or empty	config.game.table.id 가 비어있거나 없습니다.
V.27	'config.channel.wrapped' is missing or empty	config.channel.wrapped 가 비어있거나 없습니다.
V.28	Provided 'config.game.type' is not supported	제공된 config.game.type 이 지원하지 않습니다.
V.29	Provided 'config.urls.$urlType' is not valid. Should start with http://, https://, (see page 8) native://, app://	제공된 config.urls.$urlType 가 올바르지 않습니다. https:// http:// native:/ app://로 시작되어야됩니다.
V.30	'player.nickname' $nickname already exists	player.nickname이 이미 존재합니다.
V.31	'player.country' $country is not valid	player.country 가 올바르지 않습니다.
V.32	'player.currency' $currency is not valid	player.currency 가 올바르지 않습니다.
V.33	'player.currency' $currency can not be updated for player from FT casino	FT casino에서 player.currency 를 업데이트할 수 없습니다.
V.34	Table with id $tableId does not exist	tableId가 존재하지 않습니다.
V.35	'player.firstName' is missing	player.firstName이 없습니다.
V.36	'player.lastName' is missing	player.lastName이 없습니다.
V.37	'config.brand.id' must be a string	config.brand.id는 반드시 글자여야됩니다.
V.38	'config.brand.skin' must be a string	config.brand.skin은 반드시 글자여야됩니다.
V.39	'config.game.category' does not exist	config.game.category가 존재하지 않습니다.
V.40	'config.channel.mobile' is not boolean	config.channel.mobile가 boolean형식이 아닙니다.
V.41	'player.id' is missing	player.id 가 없습니다.
V.42	'player.nickname' is missing - does`t present now	player.nickname이 지금은 없습니다.

보유머니 연동 ( 지갑 )

개요

Evolution gaming 안에서 유저가 베팅하고, 당첨되었을때 보유머니를 파트너사의 보유머니와 연동하기 위하여 필요합니다.

Evolution gaming 서버에서 요청하는 유저의 보유머니 관련 요청 5가지에 대응합니다.

사용법

Evolution gaming 안에서의 보유머니 변동사항을 파트너사의 서버로 전송됩니다.

보유머니변동 사항을 받아볼 수 있도록 웹서버를 아래 규격에 맞춰 대응하여야됩니다.

파트너가 정한 경로

각 파트너사에서 정한 임의의 경로로 Evol에서 요청을 하게 되며, 이 요청을 수신받아서 JSon으로 응답을 해주시면 됩니다.

Check ( 유저 상태 확인 )

유저가 베팅을 할 수 있는지 여부를 확인하는 요청입니다.

Evolution gaming에서 요청

파라미터

이름	데이터 타입	설명
sid	string	게임 세션 발급시 파트너에서 보내준 세션 아이디입니다.
userid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 아이디입니다.
channel	object	채널의 정보가 담겨있습니다.
channel.type	string	유저를 위한 Evolution gaming의 채널 타입입니다. M : 모바일 환경 P : 그외의 모든 환경
uuid	string	요청의 고유한 아이디입니다.

URL 예시

https://<파트너사이트(도메인)>/<파트너가 정한 Check 경로>?authToken=<토큰>

HTTP BODY 예시


	{
		"sid": "<세션 아이디>",
		"userid": "<유저의 아이디>",
		"channel": {
			"type": "<모바일 환경 여부>"
		},
		"uuid": "<요청의 고유 아이디>"
	}

파트너사에서 응답

파라미터

이름	데이터 타입	설명
status	string	요청에 대한 결과입니다. * 기본값은 OK 여야되며, 임의로 에러코드를 넣어주시거나 응답헤더가 200가 아니면 에러로 취급합니다. * http 응답 헤더가 200 이 아니면, TEMPORARY_ERROR 입니다. * http 응답이 형태에 맞지 않으면, TEMPORARY_ERROR 입니다. * 상태값이 상태값 목록에 존재하지 않다면, UNKNOWN_ERROR 입니다.
sid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 세션 아이디입니다.
uuid	string	응답의 고유 아이디입니다.

HTTP BODY예시


	{
		"status": "OK",
		"sid": "<요청에 있던 세션 아이디>",
		"uuid": "<응답의 고유 아이디>"
	}

Balance ( 유저 보유머니 확인 )

유저의 보유머니를 확인하는 요청입니다.

Evolution gaming에서 요청

파라미터

이름	데이터 타입	설명
sid	string	게임 세션 발급시 파트너에서 보내준 세션 아이디입니다.
userid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 아이디입니다.
currency	string	통화코드 입니다. ( 한국 KRW )
game	object	게임정보가 담겨있습니다. * 게임에 들어간경우가 아닌경우에는 game 이 null 일 수 있습니다. ( 예: 로비입장 ) * game.type 데이터를 사용하여 특정 게임을 제한하는데 사용할 수 있습니다.
game.type	string	게임 타입이 들어갑니다. ( 예 : blackjack, roulette )
game.details	object	추가적인 게임 정보가 담겨있습니다.
game.details.table	object	게임을 위한 테이블 정보가 담겨있습니다.
game.details.table.id	string	고유한 테이블 아이디
game.details.table.vid	string	고유한 가상테이블 아이디
uuid	string	요청의 고유 아이디입니다.

URL 예시

https://<파트너사이트(도메인)>/<파트너가 정한 Balance 경로>?authToken=<토큰>

HTTP BODY 예시


	{
		"sid": "<세션 아이디>",
		"userid": "<유저의 아이디>",
		"currency": "KRW",
		"game": {
			"type": "<게임 타입>",
			"details": {
				"table": {
					"id": "<고유한 테이블 식별자>",
					"vid": "<고유한 가상 테이블 식별자>"
				}
			}
		},
		"uuid": "<요청의 고유 아이디>"
	}

파트너사에서 응답

파라미터

이름	데이터 타입	설명
status	string	요청에 대한 결과입니다. * 기본값은 OK 여야되며, 임의로 에러코드를 넣어주시거나 응답헤더가 200가 아니면 에러로 취급합니다. * http 응답 헤더가 200 이 아니면, TEMPORARY_ERROR 입니다. * http 응답이 형태에 맞지 않으면, TEMPORARY_ERROR 입니다. * 상태값이 상태값 목록에 존재하지 않다면, UNKNOWN_ERROR 입니다.
balance	decimal	플레이어의 보유머니입니다. 이 값은 항상 채워져있어야됩니다. 다만, 아래와 같은경우에는 비어있을 수 있습니다. * Balance요청에서 파트너가 유저의 보유머니를 알 수 없을때, * 오류 / 실패 조치로 인해 잔액을 확보 할 수 없는 경우
bonus	decimal	사용하지 않습니다. * 0.00 으로 고정해야됩니다.
retransmission	boolean	이 응답이 이미 같은 uuid를 가진 요청으로 인해 재발송되는경우 true ( 예 : 만약 요청이 네트워크 오류로 인해 재발송이되면 retransmission가 true 여야됩니다.), 그 이외의 모든 상황에서는 false 이거나 retransmission가 응답에 포함되어있으면 안됩니다.
uuid	string	응답의 고유 아이디입니다.

HTTP BODY예시


	{
		"status": "OK",
		"balance": <유저의 보유머니>,
		"bonus": 0.00,
		"uuid": "<응답의 고유 아이디>"
	}

Debit ( 유저 베팅 => 보유머니 차감 )

유저가 베팅할때 보유머니를 차감하기 위한 요청입니다.

Evolution gaming에서 요청

파라미터

이름	데이터 타입	설명
sid	string	게임 세션 발급시 파트너에서 보내준 세션 아이디입니다.
userid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 아이디입니다.
currency	string	통화코드 입니다. ( 한국 KRW )
game	object	게임정보가 담겨있습니다. * 게임에 들어간경우가 아닌경우에는 game 이 null 일 수 있습니다. ( 예: 로비입장 ) * game.type 데이터를 사용하여 특정 게임을 제한하는데 사용할 수 있습니다.
game.id	string	고유한 게임라운드 아이디입니다. Debit, Credit, Cancel 요청에서만 제공되며 Balance요청에서는 제공하지 않습니다.
game.type	string	게임 타입이 들어갑니다. ( 예 : blackjack, roulette )
game.details	object	추가적인 게임 정보가 담겨있습니다.
game.details.table	object	게임을 위한 테이블 정보가 담겨있습니다.
game.details.table.id	string	고유한 테이블 아이디
game.details.table.vid	string	고유한 가상테이블 아이디
transaction	object	거래 세부사항을 포함하는 오브젝트입니다.
transaction.id	string	거래의 고유 아이디입니다. ( 예 : 중복된 베팅을 감지하거나 다른 검증에 사용될 수 있습니다.)
transaction.refId	string	거래에 대한 참조 식별자, Debit요청에 대한 검증/취소 요청을 연결하거나 확인할 수 있습니다.
transaction.amount	decimal	거래량
uuid	string	요청의 고유 아이디입니다.

URL 예시

https://<파트너사이트(도메인)>/<파트너가 정한 Debit 경로>?authToken=<토큰>

HTTP BODY 예시


	{
		"sid": "<세션 아이디>",
		"userid": "<유저의 아이디>",
		"currency": "KRW",
		"game": {
			"id": "<고유한 게임라운드 아이디>",
			"type": "<게임 타입>",
			"details": {
				"table": {
					"id": "<고유한 테이블 식별자>",
					"vid": "<고유한 가상 테이블 식별자>"
				}
			}
		},
		"transaction": {
			"id": "<거래의 고유 아이디>",
			"refId": "<거래에 대한 참조 식별자>",
			"amount": <거래량>
		},
		"uuid": "<요청의 고유 아이디>"
	}

파트너사에서 응답

파라미터

이름	데이터 타입	설명
status	string	요청에 대한 결과입니다. * 기본값은 OK 여야되며, 임의로 에러코드를 넣어주시거나 응답헤더가 200가 아니면 에러로 취급합니다. * http 응답 헤더가 200 이 아니면, TEMPORARY_ERROR 입니다. * http 응답이 형태에 맞지 않으면, TEMPORARY_ERROR 입니다. * 상태값이 상태값 목록에 존재하지 않다면, UNKNOWN_ERROR 입니다.
balance	decimal	플레이어의 보유머니입니다. 이 값은 항상 채워져있어야됩니다. 다만, 아래와 같은경우에는 비어있을 수 있습니다. * Balance요청에서 파트너가 유저의 보유머니를 알 수 없을때, * 오류 / 실패 조치로 인해 잔액을 확보 할 수 없는 경우
bonus	decimal	사용하지 않습니다. * 0.00 으로 고정해야됩니다.
retransmission	boolean	이 응답이 이미 같은 uuid를 가진 요청으로 인해 재발송되는경우 true ( 예 : 만약 요청이 네트워크 오류로 인해 재발송이되면 retransmission가 true 여야됩니다.), 그 이외의 모든 상황에서는 false 이거나 retransmission가 응답에 포함되어있으면 안됩니다.
uuid	string	응답의 고유 아이디입니다.

HTTP BODY예시


	{
		"status": "OK",
		"balance": <유저의 보유머니>,
		"bonus": 0.00,
		"uuid": "<응답의 고유 아이디>"
	}

Credit ( 게임 결과 => 보유머니 증가 )

게임이 종료되어 보유머니를 증가를 위한 요청입니다.

Evolution gaming에서 요청

파라미터

이름	데이터 타입	설명
sid	string	게임 세션 발급시 파트너에서 보내준 세션 아이디입니다.
userid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 아이디입니다.
currency	string	통화코드 입니다. ( 한국 KRW )
game	object	게임정보가 담겨있습니다. * 게임에 들어간경우가 아닌경우에는 game 이 null 일 수 있습니다. ( 예: 로비입장 ) * game.type 데이터를 사용하여 특정 게임을 제한하는데 사용할 수 있습니다.
game.id	string	고유한 게임라운드 아이디입니다. Debit, Credit, Cancel 요청에서만 제공되며 Balance요청에서는 제공하지 않습니다.
game.type	string	게임 타입이 들어갑니다. ( 예 : blackjack, roulette )
game.details	object	추가적인 게임 정보가 담겨있습니다.
game.details.table	object	게임을 위한 테이블 정보가 담겨있습니다.
game.details.table.id	string	고유한 테이블 아이디
game.details.table.vid	string	고유한 가상테이블 아이디
transaction	object	거래 세부사항을 포함하는 오브젝트입니다.
transaction.id	string	거래의 고유 아이디입니다. ( 예 : 중복된 베팅을 감지하거나 다른 검증에 사용될 수 있습니다.)
transaction.refId	string	거래에 대한 참조 식별자, Debit요청에 대한 검증/취소 요청을 연결하거나 확인할 수 있습니다.
transaction.amount	decimal	거래량
uuid	string	요청의 고유 아이디입니다.

URL 예시

https://<파트너사이트(도메인)>/<파트너가 정한 Credit 경로>?authToken=<토큰>

HTTP BODY 예시


	{
		"sid": "<세션 아이디>",
		"userid": "<유저의 아이디>",
		"currency": "KRW",
		"game": {
			"id": "<고유한 게임라운드 아이디>",
			"type": "<게임 타입>",
			"details": {
				"table": {
					"id": "<고유한 테이블 식별자>",
					"vid": "<고유한 가상 테이블 식별자>"
				}
			}
		},
		"transaction": {
			"id": "<거래의 고유 아이디>",
			"refId": "<거래에 대한 참조 식별자>",
			"amount": <거래량>
		},
		"uuid": "<요청의 고유 아이디>"
	}

파트너사에서 응답

파라미터

이름	데이터 타입	설명
status	string	요청에 대한 결과입니다. * 기본값은 OK 여야되며, 임의로 에러코드를 넣어주시거나 응답헤더가 200가 아니면 에러로 취급합니다. * http 응답 헤더가 200 이 아니면, TEMPORARY_ERROR 입니다. * http 응답이 형태에 맞지 않으면, TEMPORARY_ERROR 입니다. * 상태값이 상태값 목록에 존재하지 않다면, UNKNOWN_ERROR 입니다.
balance	decimal	플레이어의 보유머니입니다. 이 값은 항상 채워져있어야됩니다. 다만, 아래와 같은경우에는 비어있을 수 있습니다. * Balance요청에서 파트너가 유저의 보유머니를 알 수 없을때, * 오류 / 실패 조치로 인해 잔액을 확보 할 수 없는 경우
bonus	decimal	사용하지 않습니다. * 0.00 으로 고정해야됩니다.
retransmission	boolean	이 응답이 이미 같은 uuid를 가진 요청으로 인해 재발송되는경우 true ( 예 : 만약 요청이 네트워크 오류로 인해 재발송이되면 retransmission가 true 여야됩니다.), 그 이외의 모든 상황에서는 false 이거나 retransmission가 응답에 포함되어있으면 안됩니다.
uuid	string	응답의 고유 아이디입니다.

HTTP BODY예시


	{
		"status": "OK",
		"balance": <유저의 보유머니>,
		"bonus": 0.00,
		"uuid": "<응답의 고유 아이디>"
	}

Cancel ( 베팅 취소 또는 오류 대처 )

베팅이 여러이유로 취소되거나 보유머니증감이 제대로 이루워지지 않은 경우를 위한 요청입니다.

Evolution gaming에서 요청

파라미터

이름	데이터 타입	설명
sid	string	게임 세션 발급시 파트너에서 보내준 세션 아이디입니다.
userid	string	게임 세션 발급시 파트너에서 보내준 플레이어의 아이디입니다.
currency	string	통화코드 입니다. ( 한국 KRW )
game	object	게임정보가 담겨있습니다. * 게임에 들어간경우가 아닌경우에는 game 이 null 일 수 있습니다. ( 예: 로비입장 ) * game.type 데이터를 사용하여 특정 게임을 제한하는데 사용할 수 있습니다.
game.id	string	고유한 게임라운드 아이디입니다. Debit, Credit, Cancel 요청에서만 제공되며 Balance요청에서는 제공하지 않습니다.
game.type	string	게임 타입이 들어갑니다. ( 예 : blackjack, roulette )
game.details	object	추가적인 게임 정보가 담겨있습니다.
game.details.table	object	게임을 위한 테이블 정보가 담겨있습니다.
game.details.table.id	string	고유한 테이블 아이디
game.details.table.vid	string	고유한 가상테이블 아이디
transaction	object	거래 세부사항을 포함하는 오브젝트입니다.
transaction.id	string	거래의 고유 아이디입니다. ( 예 : 중복된 베팅을 감지하거나 다른 검증에 사용될 수 있습니다.) * Cancel 요청에서의 `transaction.id`에 취소되어야되는 거래의 아이디가 포함됩니다. ( 예: transaction.id 가 '123'인 거래에 대한 취소요청에는 transaction.id = '123'가 포함됩니다. * 주의 : 취소를 처리할 때 거래금액을 사용해서는 안되며 추가 유효성 검사에만 사용할 수 있습니다. 오로지 transaction.id만을 사용하여 취소를 실행해야됩니다.
transaction.refId	string	거래에 대한 참조 식별자, Debit요청에 대한 검증/취소 요청을 연결하거나 확인할 수 있습니다.
transaction.amount	decimal	거래량
uuid	string	요청의 고유 아이디입니다.

URL 예시

https://<파트너사이트(도메인)>/<파트너가 정한 Cancel 경로>?authToken=<토큰>

HTTP BODY 예시


	{
		"sid": "<세션 아이디>",
		"userid": "<유저의 아이디>",
		"currency": "KRW",
		"game": {
			"id": "<고유한 게임라운드 아이디>",
			"type": "<게임 타입>",
			"details": {
				"table": {
					"id": "<고유한 테이블 식별자>",
					"vid": "<고유한 가상 테이블 식별자>"
				}
			}
		},
		"transaction": {
			"id": "<거래의 고유 아이디>",
			"refId": "<거래에 대한 참조 식별자>",
			"amount": <거래량>
		},
		"uuid": "<요청의 고유 아이디>"
	}

파트너사에서 응답

파라미터

이름	데이터 타입	설명
status	string	요청에 대한 결과입니다. * 기본값은 OK 여야되며, 임의로 에러코드를 넣어주시거나 응답헤더가 200가 아니면 에러로 취급합니다. * http 응답 헤더가 200 이 아니면, TEMPORARY_ERROR 입니다. * http 응답이 형태에 맞지 않으면, TEMPORARY_ERROR 입니다. * 상태값이 상태값 목록에 존재하지 않다면, UNKNOWN_ERROR 입니다.
balance	decimal	플레이어의 보유머니입니다. 이 값은 항상 채워져있어야됩니다. 다만, 아래와 같은경우에는 비어있을 수 있습니다. * Balance요청에서 파트너가 유저의 보유머니를 알 수 없을때, * 오류 / 실패 조치로 인해 잔액을 확보 할 수 없는 경우
bonus	decimal	사용하지 않습니다. * 0.00 으로 고정해야됩니다.
retransmission	boolean	이 응답이 이미 같은 uuid를 가진 요청으로 인해 재발송되는경우 true ( 예 : 만약 요청이 네트워크 오류로 인해 재발송이되면 retransmission가 true 여야됩니다.), 그 이외의 모든 상황에서는 false 이거나 retransmission가 응답에 포함되어있으면 안됩니다.
uuid	string	응답의 고유 아이디입니다.

HTTP BODY예시


	{
		"status": "OK",
		"balance": <유저의 보유머니>,
		"bonus": 0.00,
		"uuid": "<응답의 고유 아이디>"
	}

원본 메뉴얼

원본 메뉴얼 다운로드