• 1. 개요



  • 1.1 제품 목록

    제품 아이디

    공급자

    타입

    설명

    5001

    에볼루션


    아이프레임은 allowfullscreen = true로 설정하십시오

    0

    기본 로비

    1

    RNG 블랙 잭

    2

    RNG 머니 휠

    3

    RNG 라이트닝 룰렛

    4

    RNG 유로피안 룰렛

    5

    RNG 메가 볼

    6

    RNG 용호

    7

    RNG 바카라

    8

    RNG 톱 카드

    5002

    빅 게이밍

    0

    기본 로비

    5003

    마이크로

    0

    기본 로비

    1

    그랜드 로비

    5006

    드림 게이밍

    0

    기본 로비

    5009

    섹시 게이밍

    0

    기본 로비

    5010

    프라그마틱 플레이

    0

    기본 로비

    5012

    플레이테크

    0

    기본 로비

    5016

    로얄 카지노 게이밍

    0

    기본 로비

    5018

    보타

    0

    기본 로비

    5019

    스카이윈드

    0

    기본 로비

    5022

    도윈

    0

    기본 로비

    5024

    오리엔탈 게이밍

    0

    기본 로비

    5026

    타이산

    0

    기본 로비

    5030

    아이코닉21

    0

    기본 로비

    5034

    GPI

    0

    기본 로비

    5035

    XPG

    0

    기본 로비

    5038

    DB

    0

    기본 로비


  • 1.2 슬롯 서비스 리스트

    제품 아이디

    공급자

    타입

    설명

    5000

    슬롯 로비

    0

    디폴트 슬롯 로비

    5200

    프라그마틱플레이 슬롯

    로비로 생성

    프라그마틱플레이 슬롯 게임

    5201

    하바네로

    로비로 생성

    하바네로 슬롯 게임

    5202

    엘리시움

    로비로 생성

    엘리시움 슬롯 게임

    5204

    퀵스핀

    로비로 생성

    퀵스핀 슬롯 게임

    5205

    스페이드 게이밍

    로비로 생성

    스페이드 게이밍 슬롯 게임

    5208

    월드 매치

    로비로 생성

    월드 매치 슬롯 게임

    5209

    마이크로 게이밍 슬롯

    로비로 생성

    마이크로 게이밍 슬롯 게임

    5212

    YL게이밍

    로비로 생성

    YL게이밍 슬롯 게임

    5213

    EVO 레드타이거

    로비로 생성

    EVO 레드타이거 슬롯 게임

    5214

    넷엔트

    로비로 생성

    넷엔트 슬롯 게임

    5215

    드레이곤 소프트

    로비로 생성

    드레이곤 소프트 슬롯 게임

    5216

    YGG 드라실

    로비로 생성

    YGG 드라실 슬롯 게임

    5217

    분고

    로비로 생성

    분고 슬롯 게임

    5218

    플레이슨

    로비로 생성

    플레이슨 슬롯 게임

    5219

    플레이테크 슬롯

    로비로 생성

    플레이테크 슬롯 게임

    5220

    CQ9 슬롯

    로비로 생성

    CQ9 슬롯 게임

    5221

    스카이윈드

    로비로 생성

    스카이윈드 슬롯 게임

    5223

    포켓 게임즈 소프트

    로비로 생성

    포켓 게임즈 소프트 슬롯 게임

    5224

    로얄 슬롯 게이밍

    로비로 생성

    로얄 슬롯 게이밍 슬롯 게임

    5225

    Evo 빅 타임 게이밍

    로비로 생성

    Evo 빅 타임 게이밍 슬롯 게임

    5227

    Evo 에볼 노 리미트

    로비로 생성

    Evo 에볼 노 리미트 슬롯 게임

    5228

    CC88

    로비로 생성

    CC88 슬롯 게임

    5230

    패스트 스핀

    로비로 생성

    패스트 스핀 슬롯 게임

    5231

    넥스트 스핀

    로비로 생성

    넥스트 스핀 슬롯 게임

    5249

    나가게임즈

    로비로 생성

    나가게임즈 슬롯 게임

    5253

    슬롯밀

    로비로 생성

    슬롯밀 슬롯 게임

    5254

    피터앤슨

    로비로 생성

    피터앤슨 슬롯 게임

    5255

    핵쏘 게이밍

    로비로 생성

    핵쏘 게이밍 슬롯 게임

    5256

    아바타UX

    로비로 생성

    아바타UX 슬롯 게임

    5263

    지리

    로비로 생성

    지리 슬롯 게임

    5265

    JDB

    로비로 생성

    JDB 슬롯 게임

    5267

    GPI 슬롯

    로비로 생성

    GPI 슬롯 게임


    ****참고****

    제품id 5000, 슬롯 로비는 Deposit, Withdraw, 이체여부를 수행할 수 없습니다.

    제품id 5223은 반드시 게임 인증 해야 입금 할 수 있 습니다.



  • 1.3 임시 월렛

    제품 아이디

    공급자

    타입

    설명

    0

    KPLAY

    0

    자동 이체를 위해 실패한 거래 금액을 저장하는 임시 월렛입니다.


    Auth의 입금을 위해 거래 ID로 잔고, 출금, 이체 상태 확인이 임시 기능입니다


  • 1.4 KPLAY 에서 제공하는 것

    • KPLAY 앤드 포인트

    • KPLAY AG코드

    • KPLAY AG토큰



  • 2. AUTH


    사이트에서 게임을 실행하기 위해서 아래의 API를 콜합니다. API는 자동으로 회원을 생성하거나 회원정보를 업데이트 합니다.


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/auth


  • 2.1 요청 포맷

    Header

    필드 유형

    필드 유형

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드 유형

    필드 유형

    필수

    설명

    user

    Object

    user.id

    Number

    회원의 고유 아이디


    길이 9

    user.name

    String

    회원의 고유 이름 생성 후 변경 불가


    길이 3 - 20

    user.language

    String

    한국어 : ko,

    영어 : en

    user.currency

    String

    회원통화.

    user.domain_url

    String

    (슬롯 로비 전용)


    이 필드는 귀사의 도메인으로 콜백하고 게임으로 리디렉션할때에 필요합니다.

    prd

    object

    prd.id

    Number

    제품 ID


    제품 목록 1.1 & 1.2 제품 목록


    제품 ID 5000, 슬롯 로비는 입금에 적용되지 않습니다

    prd.type

    Number

    게임 아이디, 슬롯 로비에 접속할 때 '0'을 넣어주세요

    prd.filter

    Number

    아니오

    슬롯 로비 전용


    로비에 들어갈 때 특정 제품 ID로 필터링할 때 사용합니다.


    ID는 1.2 를 나타낼 수 있습니다

    prd.open_type

    String

    아니오

    슬롯 로비 전용


    n – 새 탭, r – 리디렉션

    기본값: n

    prd.skin

    Number

    아니오

    슬롯 로비 전용


    슬롯 로비 테마 옵션. 기본값은 "Dark 2".


    사용 가능한 제품 스킨:-

    1 - Dark 1

    2 - Light 1

    3 - Dark 2

    4 - Light 2

    prd.is_mobile

    boolean

    true 의 경우 모바일 사이트의 URL을 리턴합니다


    기본값 : 아니오

    prd.table_id

    string

    아니오

    에볼루션 라이브 카지노 테이블 ID

    17. Get Game Table ID 참조

    url




    url.lobby

    String

    아니오

    제공자가 로비 호출을 지원하는 경우 제공자에게 보낼 lobby URL

    url.cashier

    String

    아니오

    제공자가 cashier 호출을 지원하는 경우 제공자에게 보낼 cashier URL



    ****참고****

    슬롯의 경우에 콜백 URL의 포멧은 http://{domain_url}/slots/{product_id}/{type}?isMobile=false 입니다. 이 콜백 URL을 AUTH 방법(섹션 2 유저 AUTH)과 매핑해야 합니다, {product_id}{type} 변수를 전달하여 슬롯 게임을 시작합니다.


    ****모바일사이트의 URL****

    http://{domain_url}/slots/{product_id}/{type}?isMobile=true


    요청 예

    {

    "user":{

    "id":1,

    "name":"johndoe",

    "language":"en",

    "currency":"KRW",

    "domain_url":"http://slot_game.url"

    },

    "prd":{

    "id":5001,

    "type":0,

    "is_mobile":false,

    "skin":1,

    "open_type":"n",

    "filter":5200

    },

    "url":{

    "lobby":"http://lobby.url/",

    "cashier":"http://cashier.url/"

    }

    }



  • 2.2 응답 포맷

    Body

    필드

    유형

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    user_id

    Number

    KPLAY 사용자 ID

    username

    String

    KPLAY 사용자 이름

    launch_url

    String

    시작 URL

    error

    String

    오류 메시지 상태 = 0

    txn_status

    Number

    디폴트: 상태 = 0

    이전 버전과의 호환성을 위해 사용됩니다.


    응답 예

    성공


    {

    "status":1,

    "user_id":100018,

    "username":"johndoe",

    "launch_url": "http://game.url",

    "txn_status":0

    }



    오류


    {

    "status":0,

    "error":"ACCESS_DENIED",

    "txn_status":0

    }



    오류

    설명

    INTERNAL ERROR

    이외의 에러

    ACCESS_DENIED

    사이트의 증명서 불일치

    INVALID_USER

    사용자가 존재하지 않을 경우




  • 3. AUTH DEPOSIT


    사이트에서 게임을 실행하기 위해서 아래의 API를 콜합니다. API는 자동으로 회원을 생성하거나 회원정보를 업데이트 합니다.


    ****참고****

    이 API를 호출할 때마다 마지막 3개의 입금된 제품의 월렛에서 돈을 인출하여 자동이체로 최신 auth 제품의 월렛에 입금합니다.


    마지막 3개의 입금제품에 5202, 5204, 5209 & 5219 제품ID가 포함되면 시스템은 소수점짜리 돈을 인출하지 않습니다. 해당한 제품 월렛에는 소수점짜리 돈이 남아 있을 것이다.


    자동이체 입출금 실패 경우의 금액은 제품 ID 0 - 임시 월렛에 저장됩니다.


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/auth-deposit


  • 3.1 요청 포맷

    Header

    필드 유형

    필드 유형

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드 유형

    필드 유형

    필수

    설명

    user

    Object

    user.id

    Number

    회원의 고유 아이디


    길이 9

    user.name

    String

    회원의 고유 이름 생성 후 변경 불가


    길이 3 - 20

    user.language

    String

    한국어 : ko,

    영어 : en

    user.currency

    String

    회원통화.

    user.domain_url

    String

    (슬롯 로비 전용)


    이 필드는 귀사의 도메인으로 콜백하고 게임으로 리디렉션할때에 필요합니다.

    prd

    object

    prd.id

    Number

    제품 ID


    제품 목록 1.1 & 1.2 제품 목록


    제품 ID 5000, 슬롯 로비는 입금에 적용되지 않습니다

    prd.type

    Number

    게임 아이디, 슬롯 로비에 접속할 때 '0'을 넣어주세요

    prd.filter

    Number

    아니오

    슬롯 로비 전용


    로비에 들어갈 때 특정 제품 ID로 필터링할 때 사용합니다.


    ID는 1.2 를 나타낼 수 있습니다

    prd.open_type

    String

    아니오

    슬롯 로비 전용


    n – 새 탭, r – 리디렉션

    기본값: n

    prd.skin

    Number

    아니오

    슬롯 로비 전용


    슬롯 로비 테마 옵션. 기본값은 "Dark 2".


    사용 가능한 제품 스킨:-

    1 - Dark 1

    2 - Light 1

    3 - Dark 2

    4 - Light 2

    prd.is_mobile

    boolean

    true 의 경우 모바일 사이트의 URL을 리턴합니다


    기본값 : 아니오

    url




    url.lobby

    String

    아니오

    제공자가 로비 호출을 지원하는 경우 제공자에게 보낼 lobby URL

    url.cashier

    String

    아니오

    제공자가 cashier 호출을 지원하는 경우 제공자에게 보낼 cashier URL

    deposit

    Object

    아니오

    deposit.amount

    Number

    아니오

    공급자 월렛에 입금할 금액

    deposit.txn_id

    Number

    아니오

    업체 생성 고유번호

    최대 길이 = 12



    ****참고****

    슬롯의 경우에 콜백 URL의 포멧은 http://{domain_url}/slots/{product_id}/{type}?isMobile=false 입니다. 이 콜백 URL을 AUTH 방법(섹션 2 유저 AUTH)과 매핑해야 합니다, {product_id}{type} 변수를 전달하여 슬롯 게임을 시작합니다.


    ****모바일사이트의 URL****

    http://{domain_url}/slots/{product_id}/{type}?isMobile=true


    요청 예

    {

    "user":{

    "id":1,

    "name":"johndoe",

    "language":"en",

    "currency":"KRW",

    "domain_url":"http://slot_game.url"

    },

    "prd":{

    "id":5001,

    "type":0,

    "is_mobile":false,

    "skin":1,

    "open_type":"n",

    "filter":5200

    },

    "url":{

    "lobby":"http://lobby.url/",

    "cashier":"http://cashier.url/"

    },

    "deposit":{

    "amount":10000,

    "txn_id":99999999

    }

    }



  • 3.2 응답 포맷

    Body

    필드

    유형

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    2 내부 오류

    user_id

    Number

    KPLAY 사용자 ID

    username

    String

    KPLAY 사용자 이름

    launch_url

    String

    시작 URL

    error

    String

    오류 메시지 상태 = 0

    txn_status

    Number

    입금거래상황


    0 = 실패

    1 = 성공

    2 = 내부 오류


    연동자가 8.1 transfer status api 로 출입금 상태를 확인하고 재시도를 수행할 수 있습니다.


    주의사항: 'status'가 0(오류)인 경우에도 'txn_status'는 1(성공)사황이 있습니다. txn_status가 0 아닌 경우에는 AG가 회원의 계정에서 입금 금액을 차감해야 합니다.

    transactions

    Array

    처리된 트랜잭션 리스트

    transactions.txn_id

    Number

    Product ID 0(임시지갑)에 입금하는 auth입금거래의 경우 연동자쪽에 생성transaction ID입니다.


    자동 입금의 Transaction ID 는 Kplay쪽에 생성된다.

    transactions.prd_id

    Number

    제품 ID

    transactions.amount

    Number

    제공게임 지갑에 입금 또는 출금할 금액

    transactions.type

    Char

    d = 입금

    w = 출금

    transactions.txn_status

    Number

    트랜잭션 상태


    0 = 실패

    1 = 성공


    연동자가 8.1 transfer status api 로 출입금 상태를 확인하고 재시도를 수행할 수 있습니다.

    transactions.error

    String

    txn_status = 0 시의 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "user_id":100018,

    "username":"johndoe",

    "launch_url": "http://game.url",

    "txn_status":1

    "transactions":[

    {

    "txn_id":99999999,

    "prd_id":0,

    "amount":"10000.00",

    "type":"d",

    "txn_status":1

    }

    {

    "txn_id":10000001,

    "prd_id":5001,

    "amount":"2000.00",

    "type":"w",

    "txn_status":1

    }

    {

    "txn_id":10000002,

    "prd_id":5006,

    "amount":"0.00",

    "type":"w",

    "txn_status":0

    }

    {

    "txn_id":10000003,

    "prd_id":5202,

    "amount":"12000.00",

    "type":"d",

    "txn_status":1

    }

    ]

    }



    오류


    {

    "status":0,

    "error":"ACCESS_DENIED",

    "txn_status":0

    "transactions":[]

    }



    오류

    설명

    INTERNAL ERROR

    이외의 에러

    ACCESS_DENIED

    사이트의 증명서 불일치

    INVALID_USER

    사용자가 존재하지 않을 경우




  • 4. DEPOSIT


    사이트에서 이 API를 호출하여 공급자 월렛에 입금할 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/deposit



    ****참고****

    아래 표시된 제공자의 신규 회원은 입금 전에 게임에 먼저 접속해야 합니다. 보타, 비터, 타이산, CC88.


  • 4.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드

    타입

    필수

    설명

    user

    Object

    user.id

    Number

    회원의 고유 아이디


    길이 9

    user.name

    String

    회원의 고유 이름 생성 후 변경 불가


    길이 3 - 20

    currency

    String

    회원통화

    prd

    Number

    제품 목록 1.1 & 1.2전송 상태


    제품 ID 5000, 슬롯 로비는 입금에 적용되지 않습니다.

    amount

    Number

    공급자 월렛에 입금될 금액

    txn_id

    Number

    업체 생성 고유번호

    최대 길이 = 12


    요청 예

    {

    "user":{

    "id":1,

    "name":"johndoe",

    "currency":"KRW"

    },

    "prd":5001,

    "amount":100000,

    "txn_id":1644239819287

    }



  • 4.2 응답 포맷

    Body

    필드

    유형

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    user_id

    Number

    KPLAY 사용자 ID

    username

    String

    KPLAY 사용자 이름

    balance

    Decimal (10,2)

    공급자잔액

    txn_id

    Number

    사이트에서 생성 고유 번호

    txn_status

    Number

    예금거래현황


    0 = 실패

    1 = 성공

    2 = 알 수 없는 오류


    에이전트가 8. TRANSFER STATUS 를 호출하여 입출금 상태를 확인하고 필요한 경우 다시 시도할 수 있습니다

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "user_id":100018,

    "username":AAAjohndoe,

    "balance":100000.00,

    "txn_id":1644239819287,

    "txn_status":1

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR",

    "txn_status":0

    }





  • 5. WITHDRAW


    사이트에서 이API를 호출하여 공급자 월렛에 출금할 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/withdraw


  • 5.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드

    타입

    필수

    설명

    user

    Object

    user.id

    Number

    회원의 고유 아이디


    길이 9

    user.name

    String

    회원의 고유 이름 생성 후 변경 불가


    길이 3 - 20

    currency

    String

    회원통화.

    prd

    Number

    제품 목록 1.1 & 1.2 전송 상태


    제품 ID 5000, 슬롯 로비는 입금에 적용되지 않습니다

    amount

    Decimal(10,2)


    Number for prd_id 5202,5204,5209 & 5219

    공급자 월렛에 입금될 금액


    참고: 제품 id 5202,5204,5209 & 5219 출금은 십진법을 지원하지 않습니다.

    txn_id

    Number

    업체 생성 고유번호

    최대 길이 = 12


    요청 예

    {

    "user":{

    "id":18,

    "name":"test_user",

    "currency":"KRW"

    },

    "prd":5001,

    "amount":100000.00,

    "txn_id":1644240365458

    }



  • 5.2 응답 포맷

    Body

    필드

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    user_id

    Number

    KPLAY 사용자 ID

    username

    String

    KPLAY 사용자 이름

    balance

    Decimal (10,2)

    공급자잔액

    txn_id

    Number

    업체 생성 고유번호

    txn_status

    Number

    예금거래현황


    0 = 실패

    1 = 성공

    2 = 알 수 없는 오류


    에이전트가 8. TRANSFER STATUS 호출하여 입출금 상태를 확인하고 필요한 경우 다시 시도할 수 있습니다

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "user_id":100018,

    "username":AAAjohndoe,

    "prd_id":5001,

    "balance":0.00,

    "txn_id":1644240365458,

    "txn_status":1

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR",

    "txn_status":1

    }





  • 6. BALANCE


    사이트에서 이API를 호출하여 공급자 월렛에 잔액 확인 할 수 있습니다


    HTTP 방법: POST

    URL: <KPLAY 앤드 포인트>/balance


  • 6.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드

    타입

    필수

    설명

    user

    Object

    user.id

    integer

    KPLAY 사용자 아이디

    user.currency

    String

    회원통화

    prd

    Number

    제품 목록 1.1 & 1.2 전송 상태


    제품 ID 5000, 슬롯 로비는 입금에 적용되지 않습니다


    요청 예

    {

    "user":{

    "id":10018,

    "currency":"KRW"

    },

    "prd":5001

    }



  • 6.2 응답 포맷

    Body

    필드

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    balance

    Decimal(10, 2)

    공급자 월렛에 잔액

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "balance":"9999.99"

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR"

    }



    *참고: 월렛 잔액을 공유하는 제품 그룹이 세 가지 있습니다:


    제품 아이디

    공급자

    잔액 획득 허용

    5001

    에볼루션

    5213

    레드타이거

    아니오

    5214

    넷엔트

    5227

    에볼 노 리미트

    아니오

    5010

    프라그마틱 플레이

    5200

    프라그마틱플레이 슬롯

    5012

    플레이테크

    5202

    엘리시움

    5204

    퀵스핀

    아니오

    5219

    플레이테크 슬롯

    아니오

    5003

    마이크로

    5209

    마이크로 게이밍 슬롯




  • 7. BALANCE ALL


    사이트에서 이API를 호출하여 모두 공급자 월렛에 잔액 확인 할 수 있습니다


    HTTP 방법 : POST

    URL: <KPLAY 앤드 포인트>/balance-all


  • 7.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드

    타입

    필수

    설명

    user

    Object

    user.id

    Integer

    KPLAY 사용자 아이디

    user.currency

    String

    회원통화.


    요청 예

    {

    "user":{

    "id":999157,

    "currency":"KRW"

    }

    }



  • 7.2 응답 포맷

    필드

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    data

    Arrays

    공급자 월렛에 잔액

    data.prd_id

    Number

    1.1 & 1.2 를 참조하세요

    data.balance

    Decimal (10,2)

    공급자 월렛에 잔액

    data.status

    Number

    0 = 게임 제공사의 응답 없음

    1 = 게임 제공사께 응답을 받음


    참고: 수신된 응답은 성공하거나 성공하지 않을 수 있습니다 (위 잔고 금액이 적용됩니다)


    응답 예

    성공


    {

    "status": 1,

    "data": [

    {

    "prd_id:5001,

    "balance":100.00,

    "status":1

    },

    {

    "prd_id:5010,

    "balance":100.00,

    "status":1

    },

    {

    "prd_id:5012,

    "balance":8600.00,

    "status":1

    },

    {

    "prd_id:5205,

    "balance":800.00,

    "status":1

    },

    {

    "prd_id:5212,

    "balance":900.00,

    "status":1

    },

    {

    "prd_id:5220,

    "balance":1000.00,

    "status":1

    }

    ]

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR

    }




    *참고: 월렛 잔액을 공유하는 제품 그룹이 세 가지 있으며 제품 아이디 하나만 쓰시면 됩니다:


    제품 아이디

    공급자

    잔액 획득 허용

    5001

    에볼루션

    5213

    레드타이거

    아니오

    5214

    넷엔트

    아니오

    5227

    에볼 노 리미트

    아니오

    5010

    프라그마틱 플레이

    5200

    프라그마틱플레이 슬롯

    아니오

    5012

    플레이테크

    5202

    엘리시움

    아니오

    5204

    퀵스핀

    아니오

    5219

    플레이테크 슬롯

    아니오

    5003

    마이크로

    5209

    마이크로 게이밍 슬롯




  • 8. TRANSFER STATUS


    사이트에서 이 API를 호출하여 공급자 월렛에 이전 입출금 거래 현황을 확인 할 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/transfer-status


  • 8.1 요청 포맷

    Header

    방법

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    방법

    타입

    필수

    설명

    txn_id

    Number

    출입금 의 고유 번호


    요청 예

    {

    "txn_id":1644240365458

    }



  • 8.2 응답 포맷

    방법

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    txn_status

    number

    0 = 실패

    1 = 성공

    2 = 알 수 없는 오류

    description

    number

    FAIL = 실패

    SUCCESS = 성공

    UNKNOWN = 알 수 없는 오류

    prd_id

    Number

    제품 ID, 제품 목록 1.2 전송 상태

    amount

    Number

    출입금 금액

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "txn_status":1

    "description":"SUCCESS",

    "prd_id":5228,

    "amount":"1000.00"

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR"

    }





  • 9. DATA FEED


    사이트에서 이 API를 호출하여 윈루즈 세부 정보를 검색할 수 있습니다.


    HTTP 방법 : GET

    URL : <KPLAY 앤드포인트>/feed/transaction


  • 9.1 요청 포맷

    Header

    방법

    타입

    필수

    설명

    ag-code

    String

    ag-token

    string


    Body

    방법

    타입

    필수

    설명

    start_date

    String

    날짜 포맷 YYYY-MM-DD Thh:mm:ssZ

    타임존: UTC

    예: 2022-12-12T01:00:00Z

    end_date

    String

    날짜 포맷 YYYY-MM-DD Thh:mm:ssZ

    타임존: UTC

    예: 2022-12-12T01:01:00Z


    ****참고****

    소량 데이터만 로드될 수 있습니다. start_dateend_date 사이의 차이는 5분 이하여야 합니다.


    요청 예

  • 9.2 응답 포맷

    방법

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    data

    array

    data.prd_id

    Number

    제품ID

    data.txn_id

    String

    베팅 거래 ID

    data.game_id

    Number

    게임 ID

    data.game_name

    String

    게임 이름

    data.user_id

    Number

    KPLAY 멤버 ID

    data.ag_user_id

    Number

    사이트 유저 ID

    data.username

    String

    사이트 유저 이름

    data.stake

    Decimal (10,2)

    지부금

    data.payout

    Decimal (10,2)

    충 당차금액

    data.bet_time

    String

    날짜 포맷:

    YYYY-MM-DD hh:mm:ss


    타임존: UTC

    data.settle_time

    String

    날짜 포맷:

    YYYY-MM-DD hh:mm:ss


    타임존: UTC

    data.type

    Number

    0 = 일반 베팅, 프리 스핀

    1 = 프로모션

    2 = 잭팟

    data.jackpot_amount

    Decimal (10,2)

    잭팟 당첨금

    error

    string

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":"1",

    "data":[

    {

    "prd_id":5200,

    "txn_id": "2762013201",

    "game_id":1,

    "game_name":"Ocean Lord",

    "user_id":999086,

    "ag_user_id":218,

    "username":"johndoe",

    "stake":2500,

    "payout":800,

    "bet_time":"2021-12-27 06:55:45",

    "settled_time":"2021-12-27 06:55:47",

    "type":2,

    "jackpot_amount":118668.54

    },

    {

    "prd_id":5200,

    "txn_id":"2762015991",

    "game_id":18,

    "game_name":"Let's Shoot",

    "user_id":999086,

    "ag_user_id":218,

    "username":"johndoe",

    "stake":2500,

    "payout":0,

    "bet_time":"2021-12-27 07:21:15",

    "settled_time":"2021-12-27 07:21:15",

    "type":0,

    "jackpot_amount:0

    }

    ]

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR"

    }





  • 10. GAME LIST


    사이트에서 이 API를 호출하여 제품 리스트 확인 할 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/gamelist



  • 10.1 요청 포맷

    Header

    방법

    타입

    필수

    설명

    ag-code

    string

    ag-token

    string


    Body

    방법

    타입

    필수

    설명

    language

    String

    게임 언어의 언어 옵션


    한국어: ko,

    영어 : en


    요청 예

    {

    "language": "en"

    }



  • 10.2 응답 포맷

    방법

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    game_list

    Array

    game_list.prd_id

    Number

    game_list.info

    Array

    info.game_id

    Number

    info.game_name

    String

    info.game_icon

    String

    제품 게임 아이콘 (슬롯 게임 전용)

    info.rtp

    String

    슬롯 RTP

    info.is_enabled

    Number

    0 - 허용안함

    1 - 허용함

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "game_list":{

    "5001":[

    {

    "game_id": 500015,

    "game_name":"baccarat",

    "rtp":"0",

    "is_enabled": 1

    }

    ],

    "5200":[

    {

    "game_id": 500001,

    "game_name":"Aztec Bonanza",

    "game_icon":"https://slots.kplaycasino.com/pragmatic/slots/id/1.png",

    "game_icon_large":"https://slots.kplaycasino.com/500*500/pragmatic/slots/id/1.png",

    "rtp":"97.06%",

    "is_enabled": 1

    }

    ]

    },

    "status":1

    }



    오류


    {

    "status": 0,

    "error": "INTERNAL_ERROR"

    }





  • 11. Get Game Info (선택 과목)


    해당 API를 호출 해서 KPLAY 에서 게임 정보를 얻기 수 있습니다.

    HTTP 방법 : POST

    URL : <KPLAY 앤드포인트>/gameinfo


  • 11.1 요청 포맷

    Header

    필드

    타입

    설명

    ag-code

    string

    KPLAY AG코드

    ag-token

    string

    KPLAY AG토큰


    Body

    필드

    타입

    설명

    language

    string

    게임 이름에 대한 언어 설정은 디폴트가 영어며

    한국어: ko, 영어: en

    참고: 게임 정보 API은 1분당 1번만 요청 가능 합니다.


    요청 예

    {

    "language":"en"

    }



  • 11.2 응답 포맷

    필드

    타입

    설명

    status

    integer

    오류 발생한 경우는 0

    성공한 경우는 1

    recommended

    string

    추천 게임

    popular

    string

    인기 게임

    new_game

    string

    신규 게임

    game_id

    integer

    서비스 게임 ID

    game_name

    string

    사비스 게임 이름

    error

    string

    상태 = 0인 경우의 오류 메시지

    *참고: 응답 예제에 있는 JSON 객체 Key값은 제품 ID (prd_id) 입니다


    응답 예

    성공


    {

    "status":1,

    "recommended":{

    "200":[

    {

    "game_id": 14,

    "game_name":"Wild West Gold"

    },

    "209":[

    {

    "game_id": 62,

    "game_name":"Basketball Star"

    }

    ]

    },

    "popular":{

    "202":[

    {

    "game_id": 466,

    "game_name":"Supa Crew"

    },

    "205":[

    {

    "game_id": 153,

    "game_name":"Christmas Miracles"

    }

    ]

    },

    "new_game":{

    "200":[

    {

    "game_id": 512,

    "game_name":"Kingdom of The Dead"

    },

    "220":[

    {

    "game_id": 277,

    "game_name":"Treasure Pirate"

    }

    ]

    }

    }



    오류


    {

    "status":0,

    "error":"INVALID_PARAMETER"

    }



    에러 메시지

    설명

    INVALID_PARAMETER

    무효한 사이트 비밀키

    INVALID_PRODUCT

    사이트에서 서비스 ID가 존재하지 않는 경우

    INTERNAL_ERROR

    아마존 내부 오류




  • 12. Get Push Bets (선택 과목)


    판매자는 푸시된 베팅 내역을 얻기 위해 KPLAY에서 이 API를 호출합니다.


    ● 게임 결과가 동점인 경우 플레이어와 은행가에 베팅하는 거래는 "푸시" 거래가 됩니다. 예를 들어 플레이어가 플레이어나 뱅커 중 한 명에게 내기를 걸었지만 결과는 동점인 경우 환불 금액 = pushed_amount.

    ● 푸시된 금액 = 0이면 트랜잭션에 푸시가 없습니다.

    ● 트랜잭션이 리스트에 없으면 데이터를 아직 사용할 수 없습니다.

    txn_id 필트가 있는 경우, start_dateend_date 필드가 무시하게 되고 더이상 필수 항목이 아닙니다. 특정 Txn_id가 하나만 입력하십시오.


    참고:

    ● 이것은 업체가 EVO에서만 푸시된 베팅 내역 세부 정보를 얻는 데 사용됩니다.

    ● 요청날짜는UTC+0시간대를 기반으로 정해집니다.

    ● 바카라 및 블랙잭 게임에만 적용됩니다.


    HTTP 방법 : POST

    URL : <KPLAY 앤드포인트>/getpushbets



  • 12.1 요청 포맷

    Header

    필드

    타입

    설명

    필수

    ag-code

    string

    KPLAY AG 코드

    ag-token

    string

    KPLAY AG 토큰


    Body

    필드

    타입

    설명

    필수

    start_date

    datetime

    게임 시작 일시

    12.2 요청 예

    end_date

    datetime

    게임 종료 일시

    12.2 요청 예

    prd_id

    integer

    인용하다

    1.1 제품 목록

    txn_id

    varchar

    특정 거래 ID

    12.2 요청 예


  • 12.2 요청 예

    start_date 및 end_date만 사용


    {

    "start_date": "2021-06-01T03:00:00Z",

    "end_date": "2021-06-01T04:50:00Z",

    "prd_id": 1

    }



    **참고: start/end 시작/종료 시간은 2 시간 제한됩니다


    트랜잭션 ID 사용


    {

    "prd_id" :1,

    "txn_id" :"624610570377457431"

    }



  • 12.3 리턴 포맷

    필드

    타입

    설명

    status

    integer

    0 – 오류

    1 – 성공

    data

    object

    거래 ID, 푸시된 금액, 푸시된 금액1, 및 측면 금액이 포함됩니다.


    pushed_amount (바카라 및 블랙잭에만 적용)


    바카라

    - 결과가 Tie일 때 플레이어 또는 뱅커에게 베팅 금액이 푸시됩니다


    블랙잭

    - 딜러와 플레이어의 핸드 값이 같을 때마다 푸시가 트리거됩니다

    - 푸시 22는 프리벳 블랙잭에서만 발생합니다 (게임 아이디 26)


    pushed_amount1 (바카라에만 적용)

    - pushed_amount에 추가된 푸시 금액

    - 타이에 베팅된 금액이 포함됩니다.

    - 예를 들어, push_amount는 100이며 타이에 베팅하는 금액은 50인 경우 push_amount1은 150입니다


    side_amount (바카라에만 적용)

    - 결과와 상관없이, 뱅커, 플레이어, 타이를 제외한 모든 사이드 베팅의 총 금액.

    error

    string

    잘못된 요청 포맷을 입력하실 때 뜨는 오류 메시지


  • 12.4 리턴 예

    성공 (시작 및 종료 날짜만)


    {

    "status": 1,

    "data": [

    {

    "txn_id": "624610570377450431",

    "pushed_amount": 100,

    "pushed_amount1": 100

    "side_amount": 100

    },

    {

    "txn_id": "624610570377451432",

    "pushed_amount": 0,

    "pushed_amount1": 0

    "side_amount": 0

    }

    ]

    }



    성공 (거래 ID만 사용)


    {

    "status": 1,

    "data": [

    {

    "txn_id": "624610570377457431",

    "pushed_amount": 0,

    "pushed_amount1": 0

    "side_amount": 0

    }

    ]

    }



    오류


    {

    "status": 0,

    "error": "ACCESS_DENIED"

    }



    오류

    설명

    ACCESS_DENIED

    사이트 정보가 무효한 경우.

    INVALID_PRODUCT

    프로덕트가 존재하지 않는 경우

    INVALID_DATE

    무효한 날짜를 입력된 경우

    INTERNAL ERROR

    KPLAY 내부 오류

    REQUEST_TOO_FREQUENT

    1분 이내에 동일한 서비스 ID를 2회 호출한 경우.




  • 13. WITHDRAW ALL


    사이트에서 이API를 호출하여 모든 공급자 월렛에서 잔액을 출금할 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/withdraw-all


  • 13.1 요청 포맷

    Header

    방법

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    방법

    타입

    필수

    설명

    user

    String

    user.id

    Number

    회원의 고유 아이디


    길이 9

    user.name

    String

    회원의 고유 이름 생성 후 변경 불가


    길이 3 - 20

    user.currency

    String

    회원통화

    txn_id

    string

    업체 생성 고유번호

    최대 길이 = 12


    요청 예

    {

    "user":{

    "id":18,

    "name":"test_user",

    "currency":"KRW",

    }

    "txn_id":123456

    }



  • 13.2 응답 포맷

    Body

    방법

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    user_id

    Number

    username

    Number

    transaction

    Array

    transaction.prd_id

    Number

    transaction.txn_id

    Number

    transaction.amount

    Decimal (10,2)

    출금 금액

    transaction.status

    Number

    0 = 실패

    1 = 성공

    2 = 알 수 없는 오류

    message

    String

    출금 진행 상황에 대한 메시지 표시

    error

    String

    아니오

    0 상태일 때 오류 메시지


    응답 예

    성공


    {

    "status":1,

    "user_id":999157,

    "username":"AAAchowtest71",

    "transaction":[

    {

    "prd_id":0,

    "txn_id":null,

    "amount":"0.00",

    "status":1

    "message":"Balance already 0, no perform withdraw"

    },

    {

    "prd_id":5001,

    "txn_id":null,

    "amount":"-1.00",

    "status":1

    "message":"Fail when get balance from provider"

    },

    {

    "prd_id":5010,

    "txn_id":null,

    "amount":"0.00",

    "status":1

    "message":"Balance already 0, no perform withdraw"

    },

    {

    "prd_id":5012,

    "txn_id":null,

    "amount":"0.00",

    "status":1

    "message":"Balance already 0, no perform withdraw"

    },

    {

    "prd_id":5200,

    "txn_id":111111111,

    "amount":"200.00",

    "status":1

    "message":"Success"

    }

    ]

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR"

    }



    조건

    메시지

    txn_id가 0 또는 "null"이고 amount가 "0.00"인 경우

    잔액이 이미 0, 출금을 수행하지 않습니다

    금액 = "-1.00"인 경우

    서비스에서 잔액을 받을 때 실패 되었습니다

    txn_id가 0 또는 "null"이 아니고 amount가 "0.00"인 경우

    성공 되었습니다




  • 14. AVAILABLE PRODUCT


    사이트는 이 API를 호출하여 모든 공급자의 제품 ID를 가져올 수 있습니다.


    HTTP 방법 : GET

    URL : <KPLAY 앤드 포인트>/available-product


  • 14.1 요청 포맷

    Header

    방법

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


  • 14.2 응답 포맷

    Body

    방법

    타입

    필수

    설명

    status

    Number

    0 경우 오류

    1 성공하는 경우

    prd

    Arrays

    prd.prd_id

    Number

    제품 ID


    응답 예

    성공


    {

    "status":1,

    "prd":[

    {

    "prd_id":5001

    },

    {

    "prd_id":5010

    },

    {

    "prd_id":5012

    },

    {

    "prd_id":5200

    },

    {

    "prd_id":5205

    }

    ]

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR"

    }





  • 15. BET DETAIL


    사이트는 이 API를 호출하여 베팅 정보를 가져올 수 있습니다


    HTTP 방법 : POST

    URL : <KPLAY 앤드 포인트>/betresults


  • 15.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


    Body

    필드

    타입

    필수

    설명

    lang

    String

    한국어: ko,

    영어 : en

    prd_id

    Number

    txn_id

    string


    요청 예

    {

    "lang":"en",

    "prd_id":5001,

    "txn_id":"8888888888"

    }



  • 15.2 응답 포맷

    Txn ID가 올바르고 베팅 세부 정보를 존재하는 경우에는 베팅 세부 정보 페이지를 여는 URL을 반환합니다. Txn ID가 유효하지 않거나 베팅 세부 정보를 존재하지않으면 오류 코드로 응답합니다.


    Body

    필드

    타입

    필수

    설명

    status

    Number

    0 = 실패

    1 = 성공

    error

    String

    아니오


    응답 예

    성공


    오류


    {

    "status":0,

    "error":"GAME_INFO_NOT_FOUND"

    }





  • 16. REMAINING DEPOSIT


    사이트가 AG 의 잔여한도 및 발급된 보증금을 획득하기 위하여 KPLAY 에게서 이 API 를 콜합니다.

    *Note: 이 API 는 요청 값 (request body) 이 필요없음. 분당 하나의 요청만 허용됩니다.


    HTTP 방법 : GET

    URL : <KPLAY 앤드 포인트>/remainingdeposit


  • 16.1 요청 포맷

    Header

    필드

    타입

    필수

    설명

    ag-code

    String

    ag-token

    String


  • 16.2 응답 포맷


    Body

    필드

    타입

    필수

    설명

    given_deposit

    Number

    available_deposit

    Number

    status

    Number

    0 = 실패

    1 = 성공


    응답 예

    성공


    {

    "given_deposit":10000000,

    "available_deposit":1000000,

    "status":1

    }



    오류


    {

    "status":0,

    "error":"INTERNAL_ERROR

    }





  • 17. Get Game Table ID


    업체는 사용중인 에볼루션 스킨 ID와 맞은 게임 아이디를 얻기 위하여 이 API를 호출합니다. 특정 테이블로 직접 실행할 수 있습니다.


    HTTP 방법 : GET

    URL : <KPLAY 앤드포인트>/getgametable


  • 17.1 요청 포맷

    Header

    필드

    타입

    설명

    ag-code

    String

    KPLAY AG코드

    ag-token

    String

    KPLAY AG토큰



  • 17.2 응답 포맷

    필드

    타입

    설명

    status

    Int

    0 -오류
    1 -성공

    skin_id

    Int

    AG사용중인 스킨 ID입니다.

    game_name

    String

    에볼루션의 게임 이름.

    table_id

    String

    특정 테이블로 직접 실행하기 위한 테이블 ID입니다.

    game_id

    Int

    게임 ID입니다.

    game_type

    String

    게임 타입

    error

    String

    상태가 0인 경우의 오류메세지.


  • 17.3 응답 예


    성공


    {

    "status":1,

    "tables":[

    {

    "skin_id": 9,

    "game_name":"Golden Wealth Baccarat",

    "game_id": 1,

    "table_id":[

    "gwbaccarat000001",

    "n7ltqx5j25sr7xbe"

    ],

    "game_type":"Baccarat"

    },

    {

    "skin_id": 9,

    "game_name":"Baccarat Control Squeeze",

    "game_id": 92,

    "table_id":[

    "k2oswnib7jjaaznw"

    ],

    "game_type":"Baccarat"

    }

    ]

    }







  • 18. ERROR MESSAGE



  • 18.1 API 오류 메시지

    Header

    오류 메시지

    설명

    ACCESS_DENIED

    무효한 에이전트 정보

    INVALID_PRODUCT

    무효한 서비스

    INVALID_USER

    무효한 회원 정보

    INVALID_PARAMETER

    도메인 URL이 없습니다

    INVALID_DATA_TYPE

    금액 필드의 포맷은 잘못되었습니다.

    MISSING_TXNID

    입금 거래 아이디가 없습니다

    DUPLICATED_TXNID

    중복된 거래 아이디

    UNABLE_DEPOSIT_SLOT_LOBBY

    prd_id = 5000인 경우 입금할 수 없습니다

    INTERNAL_ERROR

    알 수 없는 오류

    INVALID_NUMBER_FORMAT

    금액 필드의 포맷은 잘못되었습니다

    UNABLE_DEPOSIT_DECIMAL

    금액은 소수점이 있습니다

    INVALID_TXN_ID

    거래 아이디가 이미 존재되어 있는 경우 또는 거래 아이디가 12자리가 초과된 경우

    UNABLE_DEPOSIT_TEMP_WALLET

    임시 월렛에 입금 실패

    EXCEED_DEPOSIT_LIMIT

    입금 금액은 보증금 잔액보다 큽니다

    UNABLE_WITHDRAW_DECIMAL_FROM_SPECIFIC_PRODUCT

    특정한 서비스에서 소수점이 포함된 금액을 출금하는 경우

    INVALID_CREDENTIAL

    해당 에이전트의 회원 아이디가 아닙니다

    SHARED_WALLET

    공유 월렛의 대한 사항은 섹션 6. Balance의 참고 사항을 참조하십시오

    TXN_ID_NOT_EXIST

    거래 아이디가 존재하지 않습니다

    INVALID_LANGUAGE

    지원하지 않는 언어

    GAME_INFO_NOT_FOUND

    시스템에 해당 게임 라운드가 없습니다

    MISSING_LANGUAGE_FIELD

    언어 필트가 없습니다

    MISSING_PRD_ID_FIELD

    서비스 아이디가 없습니다

    REQUEST_TOO_FREQUENT

    해당 API는 연속적으로 콜 할 수 없습니다

    INVALID_START_DATE

    무효한 시작 날짜

    INVALID_END_DATE

    무효한 종료 날짜

    PERIOD_EXCEED_5_MINUTES

    시작 시간과 종료 시간 사이의 간격이 5분 이상임

    PREV_DEPOSIT_PENDING

    해당 회원에 대한 이전 입금은 진행중이며 입금 완료시까지 입금 및 이체상태 API를 사용할 수 없습니다.



  • 19. Appendix


  • 19.1 슬롯 로비 스킨

    1 - Dark 1



    2 - Light 1



    3 - Dark 2



    4 - Light 2