事前審査をして取引を登録する

概要

与信審査結果の取得後に取引を登録したい場合、事前審査機能をご活用ください。
事前審査機能は下記の手順でご利用いただけます。

  1. 審査対象となる取引の請求先(destination)を登録する
  2. 審査対象となる取引を事前登録する
  3. 手順2で登録した情報から取引(transaction)を本登録する

手順

1. 審査対象となる取引の請求先(destination)を登録する

請求先がすでに登録済みの場合、この手順はスキップできます。

リクエスト

curl -X POST "https://sandbox-api.mfkessai.co.jp/v1/destinations" \
-H "apikey: [apikey]" \
-H "content-type: application/json" \
-d '{
  "address1": "千代田区1-2-3",
  "address2": "サンプルビル3F",
  "cc_emails": [ "another.tanto1@example.jp", "another.tanto2@example.jp" ],
  "customer": {
    "office_name": "サンプル商事株式会社",
    "user_defined_id": "customer123456"
  },
  "department": "経理部",
  "email": "kesai.tanto@example.jp",
  "name": "請求先氏名",
  "name_kana": "セイキュウサキ シメイ",
  "prefecture": "東京都",
  "tel": "03-1234-5678",
  "title": "部長",
  "zip_code": "111-1111"
  }'

レスポンス

{
  "address1": "千代田区1-2-3",
  "address2": "サンプルビル3F",
  "cc_emails": [
    "another.tanto1@example.jp",
    "another.tanto2@example.jp"
  ],
  "customer_id": "AY9N-VPN3",
  "department": "経理部",
  "email": "kesai.tanto@example.jp",
  "id": "9NRM-A376",
  "name": "請求先氏名",
  "prefecture": "東京都",
  "tel": "03-1234-5678",
  "title": "部長",
  "zip_code": "111-1111"
}

次の手順に利用するので、idを保存しておきます。

2. 審査対象となる取引を事前登録する

リクエスト

destination_id に手順1で保存したidを設定します。

curl -X POST "https://sandbox-api.mfkessai.co.jp/v1/examinations" \
-H "accept: application/vnd.mfk.examination" \
-H "apikey: [apikey]" \
-H "content-type: application/json" \
-d '
{
  "amount": 2160,
  "destination_id": "9NRM-A376",
  "due_date": "2018-08-31T00:00:00+09:00",
  "examination_details": [
    {
      "amount": 2000,
      "description": "商品名A",
      "quantity": 2,
      "unit_price": 1000
    },
    {
      "amount": 160,
      "description": "消費税",
      "quantity": 1,
      "unit_price": 160
    }
  ]
}
'

レスポンス

{
  "destination_id": "9NRM-A376",
  "expires_at": "2018-08-14T20:41:04+09:00",
  "fixed_at": "2018-08-07T20:41:04+09:00",
  "id": "M697-4MM6",
  "status": "passed"
}

statusには以下のように審査結果が格納されています。

status 意味
passed 審査通過
rejected 審査否決
in_progress 審査待ち

審査通過の場合は、expires_atに格納されている日時までに手順.3に従って取引登録してください。
審査待ちの場合は、審査結果を得られるまで/v1/examinations/{id}で定期的に最新のステータスを取得してください。

3. 手順2で登録した情報から取引(transaction)を本登録する

審査を通過した場合のみご利用いただけます。

リクエスト

手順.2のレスポンスで取得したidが必要になります。以下はidM697-4MM6であるとした場合の例です。

curl -X POST "https://sandbox-api.mfkessai.co.jp/v1/examinations/M697-4MM6/transaction" \
-H "accept: application/vnd.mfk.transaction" \
-H "apikey: [apikey]" \
-H "content-type: application/json" \
-d '{
  "date": "2018-07-31T00:00:00+09:00",
  "email_flag": true,
  "issue_date": "2018-08-08T00:00:00+09:00",
  "posting_flag": false,
  "user_defined_id": "transaction_2018080900"
}'

レスポンス

{
  "amount": 2160,
  "destination_id": "9NRM-A376",
  "id": "7N7P-AAR6",
  "status": "examination_passed",
  "user_defined_id": "transaction_2018080900"
}

id登録した取引をキャンセルする際に必要になります。