決済失敗時のコールバック - ビットコイン決済APIドキュメント

決済失敗時のコールバック

支払いミスが発生した際に指定したコールバックURLにPOSTします。デフォルトは false となっておりますが、支払い用ボタンをAPIから作成する際にnotify_mispaymentにURLを指定すると呼びだされます。

決済失敗の条件は、決済金額に対して送付したビットコインの量が少ない場合や、支払期限が過ぎた状態で送金を行った場合、決済失敗として扱われます。

コールバックの内容

コールバックは指定されたURLにHTTP(HTTPS) POSTでリクエストされます。

{
  "mispayment": {
    "id": "CUqSuHKfww",
    "created_at": "2015-12-23 02:04:57 UTC",
    "status": "received",
    "confirmed_at": "2014-09-03 10:20:01 UTC",
    "total_native": {
      "currency": "JPY",
      "amount": "5000.0"
      },
    "total_btc": {
      "currency": "BTC",
      "amount": "0.11965"
      },
    "received_at":{
      "currency": "BTC",
      "amount": "0.61965"
    },
    "button_name": "アイテム1",
    "event": {
      "type": "received"
    },
    "custom": 123,
    "customer": {
      "name": "和田 晃一良",
      "email": "test@gmail.jp",
      "address": "東京都渋谷区東4-4-6"
    }
  }
}
  

項目 説明
order ユーザーが支払った注文情報のハッシュです。
mispayment[id] coincheck paymentで管理される一意な注文番号です。販売履歴で詳細を確認できます。
mispayment[created_at] 購入者が支払った時間です。
mispayment[status] 注文の状況です。received , confirmed , reimbursed の3種類があります。
received はビットコインを送付した瞬間で、まだ承認されていません。
confirmed はビットコインの送付が承認済みになった状態で、 receiveの後に呼ばれます。
reimbursed は返金した状態となります。
mispayment[confirmed_at] ビットコインの送金が承認された時間です。承認がされていない場合は nil が入ります。
mispayment[total_native] 支払い用ボタンを作るリクエストで指定した、価格、通貨に関する情報を含んだハッシュです。
mispayment[total_native][currency] 支払い用ボタンを作るリクエストで指定した通貨です。日本円で作成した場合は JPY であり、ビットコインで作成した場合は BTC です。
mispayment[total_native][amount] 支払い用ボタンを作るリクエストで指定した価格です。
mispayment[total_btc] 商品の価格をビットコインでのレートに換算した情報を含むハッシュです。
mispayment[total_btc][currency] 常に BTC です。
mispayment[total_btc][amount] ビットコインに換算された価格です。
mispayment[received_at] 実際に発生した決済に関する情報のハッシュです。
mispayment[received_at][currency] 常に BTC です。
mispayment[received_at][amount] 実際に受け取った金額です。
mispayment[button_name] ボタンを作るで指定した button[name] です。
mispayment[event] 注文の状況に関する情報を含むハッシュです。
mispayment[event][type] 注文の状況を表示します。
mispayment[custom] ボタン生成時に指定した、 button[custom] が入ります。
mispayment[customer] 注文をした顧客に関する情報のハッシュです。
mispayment[customer][name] 注文した顧客の名前です。ボタン生成時に button[include_name]true にした場合のみ情報が入ります。
mispayment[customer][email] 注文した顧客のメールアドレスです。ボタン生成時に button[include_email]true にした場合のみ情報が入ります。
mispayment[customer][address] 注文した顧客の住所です。ボタン生成時に button[include_address]true にした場合のみ情報が入ります。

日本語で表示しますか?

はい いいえ もう表示しない

Show in English?

Yes No Never