자금 집금과 회수

가맹점 BUSINESS 계정은 완료된 고객 결제를 내부 입금으로 수취합니다. 다음 세 가지 관점을 구분해야 합니다.

1. 결제 거래 상태는 개별 주문의 완료 여부를 증명합니다.
2. 가맹점 잔액은 현재 사용 가능하거나 출금에 예약된 자금을 보여줍니다.
3. 원장은 확정된 잔액 변동을 기록하며 거래 대사에 사용합니다.

수취한 결제 확인

가맹점 원장에서 내부 입금을 조회합니다.

wallet_request GET "/accounts/$PAYMENT_ACCOUNT_ID/ledger?asset_type_id=$ASSET_TYPE_ID&transaction_type=INTERNAL_IN&after_id=0&limit=100" | jq

고객 결제 한 건은 고객 계정에 INTERNAL_OUT / DEBIT, 가맹점 계정에 INTERNAL_IN / CREDIT을 생성합니다. 양쪽 원장 항목은 결제의 withdrawal_id를 ref_id로 공유합니다.

GET /withdrawals?account_id=$PAYMENT_ACCOUNT_ID는 가맹점 계정이 보낸 거래만 반환합니다. 고객에게 받은 결제는 해당 목록이 아니라 INTERNAL_IN 원장에서 조회합니다.

사용 가능 자금과 예약 자금 확인

wallet_request GET "/accounts/$PAYMENT_ACCOUNT_ID/balances/$ASSET_TYPE_ID" | jq

정산 전에는 금액이 available_amount_raw에 있는지 확인합니다. 외부 출금을 생성하면 금액과 수수료가 최종 상태가 될 때까지 pending_withdraw_amount_raw에 예약됩니다.

예약 상태를 정산 완료로 처리하지 마십시오.

실패한 정산의 자금 회수 확인

출금 생성 응답이 유실되었다면 새 요청을 만들기 전에 기존 client_request_id로 복구 조회합니다.

wallet_request GET "/withdrawals/client-request/$SETTLEMENT_REQUEST_ID" | jq

외부 출금이 FAILED, REJECTED, CANCELLED가 되면 상세 최종 상태를 확인하고 잔액을 다시 조회합니다.

wallet_request GET "/withdrawals/$WITHDRAWAL_ID" | jq
wallet_request GET "/accounts/$PAYMENT_ACCOUNT_ID/balances/$ASSET_TYPE_ID" | jq

출금 처리 실패 또는 거절 후 OOLIN은 예약된 출금액과 수수료를 사용 가능 잔액으로 되돌립니다. 고객 백엔드가 임의로 잔액을 가산해서는 안 됩니다. 원본 요청이 최종 상태가 된 뒤 권위 있는 잔액을 확인하고 필요한 경우에만 새 요청을 생성합니다.

다음: 결제 거래 대사