残高移行を作成する

(1) 設定

加盟店は、残高移行を開始して、自社の残高から販売事業者の残高に、またはその逆に決済資金を移行できます。

ただし、残高は移行金額以上である必要があります。そうでない場合、リクエストは失敗します。

(2) 決済資金フローのロジック

ケース 1: 加盟店から販売事業者に残高を移行する

Balance: Transfer API をリクエストして、加盟店から販売事業者への残高移行を開始してください。

curl https://komoju.com/api/v1/merchants/{merchant_id}/balances/{currency}/transfer \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
    "to": "seller_merchant_id",
    "amount": 300
}'

決済資金フローの図:

ケース 2: 販売事業者から加盟店に残高を移行する

Balance: Transfer API をリクエストして、販売事業者から加盟店への残高移行を開始してください。

curl https://komoju.com/api/v1/merchants/{merchant_id}/balances/{currency}/transfer \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
    "to": "platform_merchant_id",
    "amount": 300
}'

決済資金フローの図:

トランザクションレコードタイプの概要

上記のすべてのアクションを基に、いくつかの記録が生成されます。以下はその要約です。

レコードタイプ	説明	入金/出金
残高移行	加盟店と販売事業者間のアカウント残高の移行	どちらが受取側であるかに応じて、入金または出金になります。