인도네시아 현지 결제 SDK 요약 및 인터페이스 가이드
인도네시아 현지 결제 SDK 요약 및 인터페이스 가이드
소개
동남아시아에서 디지털 경제가 빠르게 성장함에 따라 이 지역에서 가장 큰 시장 중 하나인 인도네시아는 전자 결제에 대한 수요가 계속 증가하고 있습니다. 인도네시아 시장에 진출하고자 하는 기업에게는 현지 결제 수단에 대한 접근성이 매우 중요합니다. 이 글에서는 개발자가 효율적으로 통합을 완료하고 사용자 경험을 최적화할 수 있도록 인도네시아의 주요 현지 결제 SDK와 그 도킹 프로세스를 자세히 소개합니다.
인도네시아 현지 결제에 액세스해야 하는 이유는 무엇인가요?
- 사용자 행동대부분의 인도네시아 소비자는 국제 신용카드보다 현지 전자지갑과 은행 송금을 선호합니다.
- 정책 준수일부 거래는 규제 요건을 충족하기 위해 현지 채널을 통해 이루어져야 합니다.
- 전환율 증가익숙한 결제 방법을 제공하면 결제 포기율을 크게 줄일 수 있습니다.
주류 인도네시아 현지 결제 SDK 요약
1. 다나
- 개요Ant Group이 투자한 전자지갑으로 소매, 청구서 결제 및 기타 시나리오를 지원합니다.
- 적용 가능한 시나리오전자상거래, 게임 충전, 청구서 결제.
- 관세약 1%-2%.
- API 문서 주소::DANA 개발자 센터(등록 필요)
2. OVO
- 개요QR코드와 온라인 결제를 지원하는 Grab 에코 지원 헤드 월렛입니다.
- 특수성::
- 할부 결제 지원(PayLater)
- 높은 오프라인 가맹점 커버리지
- 도킹 방법:
- 모바일용 REST API 및 SDK 제공
- 테스트 샌드박스 환경 개선
3. 링크아자
- 국유 배경여러 은행과 통신 사업자의 잔액을 통합하는 통합 플랫폼입니다.
|기능|설명|
|—|—|
|정산 주기 |영업일 기준 T+3일|
|최저 취급 수수료|0.5%|
참고: 프로덕션 환경에 등록하려면 BPJ 세금 파일을 제출해야 합니다.
4. 은행 송금(가상 계좌)
만디리 VA, BCA VA 등 포함...
//샘플 의사 코드: BCA 가상 계정 생성
결제 요청 요청 = 새 결제 요청()
.setAmount(50000)
.setCustomerId("USER123"); .
응답 resp = BcaSdk.createVirtualAccount(요청);
일반적인 도킹 단계
1.자격 준비
인도네시아 현지 결제 SDK 도킹 단계 자세히 보기
1. 자격 준비
인도네시아 현지 결제 SDK에 액세스하기 전에 다음과 같은 기본 자료가 준비되어 있는지 확인해야 합니다:
- 회사 등록 서류(예: 사업자 면허증, 세금 등록증)
- 은행 계좌 정보(일반적으로 인도네시아 현지 은행 계좌가 필요함)
- API 요청 양식(일부 결제자는 작성하여 제출해야 함)
- BPJS 케테나가케르잔(사회보장번호, LinkAja 등 일부 플랫폼에서 필수)
⚠️ 참고: 결제 수단마다 자격 요건에 추가 요건이 있을 수 있습니다(예: OVO는 Grab 협력 증명이 필요할 수 있습니다).
2. 적합한 통합 모델 선택
비즈니스 요구 사항에 따라 적절한 도킹 방법을 선택하세요:
통합 모드 | 적용 가능한 시나리오 | 장점과 단점 |
---|---|---|
직접 API/SDK 통합 | - B2C 이커머스, 게임 충전 - 고빈도 거래 운영 |
✅ 높은 유연성 높은 개발 비용 |
타사 집계 플랫폼(Xendit, Midtrans 등) | -빠른 액세스가 가능한 중소규모 기업 -다양한 결제 채널 통합 관리 |
✅ 로우코드/노코드 프로그램 ❌ 약간 높은 취급 수수료 |
3. SDK 다운로드 및 환경 구성
DANA를 예로 들어보겠습니다:
- 인터뷰개발자 포털계정을 등록하세요.
- Android/iOS SDK를 다운로드하거나 REST API 설명서를 확인하세요.
- 키를 테스트할 샌드박스 환경을 구성합니다:
# 안드로이드 샘플 그레이들 종속성
구현 'id.dana:sdk:3.12.0'
4.핵심 기능 도킹
(1) SDK 초기화
// OVO SDK 초기화 예제
OvoPayment.init(
컨텍스트 = 애플리케이션 컨텍스트,
merchantId = "YOUR_MID",
apiKey = "TEST_123456"
)
(2) 결제 요청 시작
일반적인 매개 변수는 다음과 같습니다:
orderId
(판매자 주문 번호)금액
(IDR로 변환할 금액)고객 전화
(OVO/DANA 푸시를 위한 사용자의 휴대폰 번호)
(3) 콜백 알림 처리
구현해야 하는 서버 측 로직입니다:
# 플라스크 예시 DANA 콜백 서명 확인
@app.route('/dana/callback', methods=['POST'])
def handle_callback().
서명 = request.headers.get('X-DANA-SIGNATURE')
if verify_signature(request.data, signature).
update_order_status(request.json['orderId'])
반환 "OK",200
5.테스트 및 Go-Live 핵심 사항
(1) 샌드박스 테스트 프로세스
테스트 환경은 모든 주요 제공업체에서 이용할 수 있습니다.
||DANA 샌드박스|OVO 스테이징|
|—|—|—|
가상 계정|88810000001~100(고정)|동적 생성|
⚠️ 일반적인 오류 코드 처리.
40030: 잔액 부족(DANA)
RP03: 사용자 취소(OVO PayLater)
(2) 프로덕션 환경 전환 조건
라이브를 시작하려면 다음 단계를 완료하세요.
테스트 트랜잭션 20회 이상 성공 ✅ 테스트 트랜잭션 20회 이상 통과
✅ 공식적인 협력 계약 체결
✅ 보안 감사 완료(일부 은행 VA는 HTTPS + IP 화이트리스트가 필요함)
6.최적화 권장 사항 및 규정 준수 사항
성능 최적화
✔️ 자주 사용하는 토큰을 저장하기 위해 로컬 캐시 활성화
✔️ 조정 문서의 비동기 처리
법적 위험 회피
도박과 같은 불법 산업에 대한 접근 금지(PHYTON과 같은 플랫폼은 정기적으로 검사)
최소 10년간 거래 기록 보관(BI 규정 No22/2019에 따라) ❗ 거래 기록 보관
코드 베이스에 대한 전체 참조를 보려면 GitHub를 방문하여 "indonesia-payment-samples"를 검색하세요. 예를 들어 2024년 2분기에 GoPay는 새로운 암호화 표준인 AES-GCM으로 마이그레이션할 예정이므로 플랫폼의 변경 로그를 계속 지켜보시기 바랍니다.