日本円の出金

post
出金依頼を出す

https://api.liquid.com/withdrawals
currency, amount, bank_account_id は withdrawal に格納します。 日本円の出金を行う際に利用します。
Request
Response
Request
Body Parameters
auth_code
optional
integer
2段階認証のコードを入力します。
currency
required
string
出金したい通貨を選択します。 日本のお客様は JPY のみとなります。
amount
required
integer
出金したい数量を指定します。
bank_account_id
required
integer
出金する銀行口座のid を入力します。
Response
200: OK
{
'id': 12345,
'currency': 'JPY',
'amount': '1500.0',
'state': 'pending',
'created_at': 12345,
'bank_account': {
'id': 12345,
'acc_name': 'NAME',
'bank_branch': '支店名',
'acc_number': '12345',
'address': '.',
'swift': 'JFSA swift',
'bank_statement': {
'bank_statement': {
'url': 'url',
'thumb': {
'url': 'url'
},
'for_post': {
'url': 'url'
},
'for_logo': {
'url': 'url'
}
}
},
'status': 'approved',
'bank': 'テスト銀行',
'country': '',
'bank_statement_filename': '.png',
'reason_new_or_amendment': '',
'joint_acc_name': None,
'joint_address': None,
'joint_country': None,
'joint_city': None,
'id_document': {
'id_document': {
'url': 'no-avatar.png',
'thumb': {
'url': 'no-avatar.png'
},
'for_post': {
'url': 'no-avatar.png'
},
'for_logo': {
'url': 'no-avatar.png'
}
}
},
'id_document_filename': None,
'proof_address': {
'proof_address': {
'url': 'no-avatar.png',
'thumb': {
'url': 'no-avatar.png'
},
'for_post': {
'url': 'no-avatar.png'
},
'for_logo': {
'url': 'no-avatar.png'
}
}
},
'proof_address_filename': None
}
}

Request body の例

出金依頼の申請
出金依頼の申請
body = {
"auth_code": 123456
"withdrawal": {
"currency": "JPY",
"amount": 1500,
"bank_account_id": 100
}
}

Auth codeについて

auth code

auth_codeは基本的には不要なパラメータです。 しかしAPIトークンに対して、IPホワイトリストが設定されていない場合は必須のパラメータとなります。

get
出金情報の取得

https://api.liquid.com/withdrawals
出金状況の確認が出来ます。
Request
Response
Request
Query Parameters
currency
required
string
取得したい通貨を選択します。 日本のお客様は JPY のみとなります。
state
optional
string
現在の出金出金情報を確認するには下記のいずれかの state を指定します。 pending, processed, cancelled, reverted, declined
Response
200: OK
Cake successfully retrieved
{
'models': [
{
'id': 12345,
'currency': 'JPY',
'amount': 38000.0,
'state': 'cancelled',
'created_at': 12345,
'bank_account': {
'id': 12345,
'acc_name': 'NAME',
'bank_branch': '支店名',
'acc_number': '12345',
'address': '.',
'swift': 'JFSA swift',
'bank_statement': {
'bank_statement': {
'url': 'url',
'thumb': {
'url': 'url'
},
'for_post': {
'url': 'url'
},
'for_logo': {
'url': 'url'
}
}
},
'status': 'approved',
'bank': 'テスト銀行',
'country': '',
'bank_statement_filename': '.png',
'reason_new_or_amendment': '',
'joint_acc_name': None,
'joint_address': None,
'joint_country': None,
'joint_city': None,
'id_document': {
'id_document': {
'url': 'no-avatar.png',
'thumb': {
'url': 'no-avatar.png'
},
'for_post': {
'url': 'no-avatar.png'
},
'for_logo': {
'url': 'no-avatar.png'
}
}
},
'id_document_filename': None,
'proof_address': {
'proof_address': {
'url': 'no-avatar.png',
'thumb': {
'url': 'no-avatar.png'
},
'for_post': {
'url': 'no-avatar.png'
},
'for_logo': {
'url': 'no-avatar.png'
}
}
},
'proof_address_filename': None
}
},
],
'current_page': 1,
'total_pages': 1
}s

Statusについて

Status

pending : 保留中。キャンセル可能です。

processed: 振込手続き完了。キャンセルは不可能です。

cancelled: お客様によってキャンセル済み

reverted: 弊社から返金されました

declined: 弊社によって棄却されました

put
出金依頼のキャンセル

https://api.liquid.com/withdrawals/{id}/cancel
申請した日本円の出金依頼をキャンセル出来ます。 すでにステータスが processed の場合はキャンセル出来ません。
Request
Response
Request
Path Parameters
id
required
integer
出金依頼の id を入力します。
Response
200: OK
レスポンスはありません。