EXIMBAY 개발자센터

개요

EXIMBAY(VAN)가 서비스하는 결제 단말기의 EXIMPay APP(결제 프로그램)과 고객사 APP의 연동을 제공합니다.
EXIMBAY가 서비스하는 결제 단말기에 고객사의 UI/UX를 반영하여 직접 개발한 APP을 설치하고 실제 결제 기능은 EXIMPay APP을 연동하여 서비스하는 것을 뜻합니다.

하기 항목으로 구성되어 있습니다.
1. EXIMPay APP(SDK) to 고객사 APP 전문
2. SDK 설치 및 연동 준비하기

준비하기

단말기 APP과 고객사 APP의 연동을 위해 아래와 같이 준비합니다.

1. EXIMBAY가 서비스하고 있는 결제 단말기

Verifone T650P, Sunmi P3 Mix(예정)

단말기 관련 자세한 사항은 EXIMPay 홈페이지에서 확인하세요.

2. 연동할 고객사 APP

시작하기

구동 방식 및 이해하기

고객사 APP에 SDK 를 설치하여 필요한 함수를 호출하여 사용합니다.
EXIMPay APP은 보안인증을 받은 서비스로 보안이 필요하거나 필수 기능은 EXIMPay APP에서 실행됩니다.
고객사 APP에서는 결제 금액 입력, 결제 수단 선택 등의 View를 제공하고 컨트롤하게 됩니다.

EXIMPay SDK 적용

EXIMPay SDK (v.00) 다운로드하여 다운로드 받은 .aar 파일을 프로젝트에 적용합니다.

Gradle Sync & Build

EXIMPay-service.json 파일 추가

전달받은 EXIMPay-service.json 파일을 프로젝트 assets폴더에 추가합니다.

해당 파일은 직접 전달이 필요합니다. 해당 링크를 클릭하여 앱 개발 신청서를 작성해주세요

AgentService 시작

아래와 같이 AgentService를 활성화 후 EXIMPay APP으로부터 전송되는 데이터 수신 가능

                                    
class ClientApp : Application() {
private lateinit var serviceIntent: Intent

override fun onCreate() {
super.onCreate()

serviceIntent = Intent(this, AgentService::class.java)

/**
    * AgentService 활성화
    * @see AgentService - ForegroundService
    * 앱 시작시 서비스 활성화가 선행되어야 전문처리 가능
    */
startForegroundService(serviceIntent)
}

override fun onTerminate() {
super.onTerminate()
stopService(serviceIntent)
}
}

고객사 APP 인증 요청

고객사 APP의 인증 여부를 파악합니다. 인증 대상 등록을 위해서는 엑심베이와 별도 계약이 선행되어야 합니다.

                                    
(YourActivity).requestAuth { result ->
// 인증 결과를 리턴합니다.
// result == true : 인증성공, false : 인증실패    
}

인증에 실패한 경우 모의 테스트만 가능합니다.

인증은 EXIMPay APP과 상호작용 하여 이루어집니다. Eximbay 단말기가 아니거나, EXIMPay 앱이 설치되지 않은 단말기에 대해서는 인증이 이루어질 수 없어 모의테스트만 진행 가능합니다.

모의 테스트

미인증 및 별도 단말기 테스트시

                                    
(YourActivity).requestAuth { result ->
// 인증 결과를 리턴합니다.
// result == true : 인증성공, false : 인증실패    
}

폼 작성 후 제출시 isDev 파라미터 값을 true로 설정하여 요청에 대해 가응답을 내려받을 수 있습니다.