인도네시아 현지 결제 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으로 마이그레이션할 예정이므로 플랫폼의 변경 로그를 계속 지켜보시기 바랍니다.

인도네시아 현지 결제 SDK 요약 및 인터페이스 가이드