日本円の出金

出金依頼を出す

POST https://api.liquid.com/withdrawals

currency, amount, bank_account_id は withdrawal に格納します。 日本円の出金を行う際に利用します。

Request Body

Name	Type	Description
auth_code	integer	2段階認証のコードを入力します。
currency	string	出金したい通貨を選択します。 日本のお客様は JPY のみとなります。
amount	integer	出金したい数量を指定します。
bank_account_id	integer	出金する銀行口座のid を入力します。

200

{
    '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

出金状況の確認が出来ます。

Query Parameters

Name	Type	Description
currency	string	取得したい通貨を選択します。 日本のお客様は JPY のみとなります。
state	string	現在の出金出金情報を確認するには下記のいずれかの state を指定します。 pending, processed, cancelled, reverted, declined

200 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 の場合はキャンセル出来ません。

Path Parameters

Name	Type	Description
id	integer	出金依頼の id を入力します。

200

レスポンスはありません。