Overview

Overview

본 API 문서는 기술 담당자와 개발자를 위해 작성되었으며, 연동 과정에서 발생할 수 있는 문제를 최소화하기 위해 상세한 설명과 실제 사례를 포함하고 있습니다. 문서의 각 섹션은 논리적 순서로 구성되어 있어 단계별 구현이 가능합니다.

시작하기에 앞서, 아래의 연동 프로세스 개요를 확인해 주시기 바랍니다.

1. 제휴 신청 및 계약 체결

2. API 인증 키 발급 및 테스트 환경 접근 권한 부여

   1. 백오피스 마이페이지에서 API 정보(agent ID, API key)를 확인하고 callback URL을 등록해야 연동이 가능합니다.

3. 테스트 연동 및 검증

   1. 테스트 연동은 스테이지 환경에서 진행됩니다.

4. 운영 환경 전환 및 서비스 오픈

   1. 스테이지 연동 완료 후, 프로덕션 환경을 제공하여 실제 서비스를 시작합니다.

Security

META Platform의 보안과 안정성을 최우선으로 고려하여, 모든 API 통신은 SSL/TLS 암호화를 통해 이루어집니다. 또한 실시간 모니터링 시스템을 통해 서비스의 가용성을 24/7 보장하며, 장애 발생 시 즉각적인 대응이 가능한 체계를 갖추고 있습니다. 이러한 견고한 기술 기반을 토대로, 파트너사들은 안심하고 서비스를 운영할 수 있습니다.

또한, META Platform 과 운영사 시스템 간의 통신은 인증이 이루어져야 합니다. 인증 과정은 META Platform 과 운영사 시스템 간에 공유되는 agent id, api key, token 을 통해 상호 수행됩니다. 자세한 내용은 보안 페이지에서 확인 하실 수 있습니다.

Formats

운영사 시스템에서 제공하는 지갑(Wallet) 엔드포인트는 JSON 형식의 데이터 교환 방식을 사용하는 RESTful 웹 서비스로 구현되어야 하며, 문자 인코딩은 UTF-8을 사용해야 합니다.

모든 요청과 응답에서 사용되는 통화 코드는 ISO 4217 표준에 따라 3자리 문자 코드로 표기해야 합니다(예: “USD”).

국가 코드는 ISO 3166-1 alpha-2 표준을 준수하는 2자리 문자 코드로 표기해야 합니다(예: “US”).

언어 코드는 ISO 639-1 표준의 2자리 언어 코드와 ISO 3166-1 alpha-2의 2자리 국가 코드를 결합한 형태로 표기해야 합니다(예: “en_US”).

Connect and Read Timeout

META 플랫폼의 HTTP 연결 타임아웃은 3초로 설정되어 있으며, 읽기 타임아웃은 5초입니다. 운영사 시스템에 대한 요청이 이 타임아웃 값을 초과하면 해당 트랜잭션은 중단됩니다. 필요한 경우, 진행 중이던 모든 관련 트랜잭션은 롤백되거나 재시도됩니다.

Idempotency

지갑(Common Wallet) 엔드포인트의 트랜잭션 관련 메서드는 멱등성(idempotent)을 가져야 합니다. 즉, 같은 트랜잭션(입금, 출금 또는 롤백)이 오류 발생 시 재시도될 수 있지만, 재시도로 인해 운영사 시스템에서 새로운 트랜잭션이 생성되어서는 안 됩니다. 재시도 요청은 원본 응답(original response)을 반환해야 합니다.

고객지원

META Platform은 파트너사의 비즈니스 성장을 위한 다양한 지원 체계를 마련하고 있습니다. 24시간 기술 지원팀이 상시 대기하고 있으며, 정기적인 시스템 업데이트를 통해 최신 게임 트렌드와 기술 발전을 반영합니다. 또한 파트너사별 맞춤형 비즈니스 컨설팅을 제공하여, 수익 최적화를 위한 전략적 조언을 제공합니다.