문서 / 결제 플로우

결제 API 작동 방식

입금 생성과 결제 확인부터 자금 적립, 출금, 환불 및 재무 대사까지 전체 결제 경로를 확인하세요.

결제 통합 보기
입금
생성 및 적립
지급
검증 및 전송
상태
처리 확인
대사
재무 통제
결제 플로우

요청부터 최종 결과까지

01
처리 생성

플레이어, 금액, 통화, 결제 수단 및 고유 처리 번호를 기록합니다.

02
결제 확인

플레이어를 결제 페이지로 리디렉션하거나 은행 확인을 요청하거나 결제를 직접 처리합니다.

03
최종 상태 수신

결제 제공업체의 응답을 확인하고 처리의 최종 결과를 확정합니다.

04
잔액 및 회계 업데이트

자금을 한 번만 적립 또는 차감하고 수수료를 반영하며 대사를 위해 처리를 기록합니다.

개요

모든 결제는 통제된 단계를 거칩니다

플랫폼은 자체 처리 번호를 부여하고 결제 제공업체 응답과 연결하며 확인된 결과 이후에만 금융 상태를 변경합니다. 반복 요청은 두 번째 차감 또는 적립을 만들면 안 됩니다.

단일 처리 번호

플레이어, 금액, 통화, 결제 수단, 결제 제공업체 및 전체 처리 이력을 연결합니다.

명확한 상태

처리는 허용된 단계로만 이동하며 별도 정정 없이 완료된 결과를 변경하지 않습니다.

별도 금융 회계

결제 상태, 잔액 변경, 수수료 및 회계 기록은 서로 연결되지만 각각 별도로 확인합니다.

입금 플로우

일반적인 입금 플로우

입금은 내부 처리로 시작하고 결제 제공업체의 확인 후 한 번의 적립으로 끝납니다.

01

요청 검증 및 처리 생성

플랫폼은 플레이어, KYC, 한도, 통화, 금액 및 결제 수단을 확인한 후 내부 처리 번호를 부여합니다.

02

결제를 제공업체로 전송

제공업체는 금액, 통화, 플레이어 데이터, 반환 URL, 알림 URL 및 필요한 결제 정보를 받습니다.

03

결제 확인

플레이어는 외부 페이지, 3-D Secure 또는 뱅킹 앱에서 결제를 확인합니다.

04

확인 수신 및 자금 적립

서명과 최종 상태를 검증한 후 플랫폼은 플레이어 잔액을 한 번만 증가시키고 처리를 완료합니다.

출금 및 환불

출금, 취소 및 환불

출금 처리는 플레이어, 사용 가능 잔액, 위험, 결제 정보 및 결제 제공업체의 최종 응답을 검증해야 합니다.

플레이어 검증

KYC, 연령, 계정 상태, 한도, 자기차단 및 허용된 출금 수단.

위험 점검

AML, 사기 지표, 베팅 조건, 자금 출처 및 운영사 승인.

금액 예약

최종 지급 결과를 받을 때까지 금액을 잔액에서 보류합니다.

결제 제공업체로 전송

고유 번호와 검증된 수취인 정보로 별도 지급 요청을 생성합니다.

결과 대기

플랫폼은 중간 상태를 수신하되 금액을 다시 차감하지 않습니다.

환불

환불은 원래 결제와 연결된 별도 처리로 생성되며 자체 금액을 가집니다.

취소

취소는 되돌릴 수 없는 단계 전까지만 가능하며 이미 완료된 처리의 환불을 대체하지 않습니다.

최종 대사

제공업체 보고서, 지급 데이터, 수수료 및 잔액 변경이 동일한 결과를 보여야 합니다.

처리 상태

권장 상태 모델

내부 상태는 서로 다른 결제 제공업체의 응답을 플랫폼의 하나의 명확한 모델로 정규화합니다.

생성됨

플랫폼 내에서 처리가 생성되었지만 아직 제공업체로 전송되거나 수락되지 않았습니다.

사용자 조치 필요

플레이어가 결제를 확인하거나 정보를 입력하거나 은행에서 조치를 취해야 합니다.

처리 중

제공업체가 처리를 수락했지만 최종 결과는 아직 확정되지 않았습니다.

완료

처리가 성공적으로 완료된 후 잔액을 한 번만 변경합니다.

거절됨

거절 사유를 보관한 채 처리가 종료되며 추가 차감이나 적립은 발생하지 않습니다.

미확정

연결 실패, 응답 지연 또는 상충되는 데이터로 인해 처리 결과를 알 수 없습니다.

결과 불명을 거절로 간주해서는 안 됩니다

제때 응답이 없더라도 결제가 제공업체에서 수락되었을 수 있습니다. 먼저 현재 상태를 조회하거나 확인을 기다린 후에야 다른 처리가 필요한지 판단해야 합니다.

신뢰성 및 대사

중복 방지 및 재무 대사

결제 API의 신뢰성은 반복 요청, 지연된 확인 및 부분 장애를 안전하게 처리하는 데 달려 있습니다.

반복 처리 방지

모든 입금, 출금 및 환불에는 고유 번호가 부여됩니다.
반복 요청은 기존 결과를 반환하며 새로운 금융 처리를 생성하지 않습니다.
반복 알림은 이벤트 번호와 현재 결제 상태를 기준으로 확인합니다.
잔액 변경은 결제 번호와 연결되며 한 번만 적용됩니다.

재무 회계 및 대사

금액, 수수료, 순금액, 통화 및 제공업체 참조값을 각각 별도로 저장합니다.
완료된 기록을 소급해 덮어쓰지 말고 별도 정정 처리를 생성합니다.
API 처리, 제공업체 보고서, 잔액 변경 및 지급을 대사합니다.
각 차이, 원인, 담당자 및 해결 결과를 기록합니다.
테스트

출시 전 테스트 항목

성공 결제, 거절, 연결 끊김, 반복 확인, 결과 불명, 환불 및 재무 대사를 테스트합니다.

성공 입금 및 출금

모든 중간 상태, 확인, 잔액 변경 및 최종 보고.

처리 거절

잔액 부족, 잘못된 정보, 한도 초과, 은행 거절, 위험 검토 및 이용 불가능한 결제 수단.

연결 끊김

요청 전송 후 연결이 끊기고 이후 확인이 도착하거나 별도로 조회됩니다.

반복 요청

처리가 완료된 후 동일한 처리 또는 확인이 다시 도착합니다.

환불 및 취소

전체 및 부분 환불, 처리 전 취소, 완료된 처리 취소 금지.

대사

모든 시나리오 이후 금액, 수수료, 최종 상태, 잔액 및 제공업체 보고서가 일치합니다.

출시 전 체크리스트

상태, 확인, 중복 방지, 잔액 및 재무 보고가 검증된 후 운영 결제를 활성화합니다.

테스트 환경과 운영 환경은 서로 다른 자격 증명, 알림 엔드포인트 및 계정을 사용합니다.
사용자의 웹사이트 복귀를 결제 성공의 증거로 사용하지 않습니다.
잔액을 변경하기 전에 서명과 이벤트 번호를 검증합니다.
입금, 출금 및 환불은 반복 실행으로부터 보호됩니다.
알 수 없는 상태는 제공업체와 확인하고 대사 과정에서 검증합니다.
오류 알림, PSP 보고서 및 차이 조사 프로세스가 구성되어 있습니다.

결제 플로우를 설계해야 하나요?

PSP 목록, 결제 수단, 통화, 시장, 잔액 규칙 및 상태를 보내 주세요. APIACE가 입금, 출금, 환불, 확인 및 재무 대사를 구조화하도록 지원합니다.