cancelInvoice¶
- インボイスのキャンセル
作成したインボイスを取消します。 支払が完了していたり既に有効期限が切れている場合はエラーとなります。 部分的に入金されていた場合は、過払いとして処理されます。
パラメータ¶
パラメータ | 必須 | 詳細 | 型 | 値または例 |
---|---|---|---|---|
method | Yes | メソッド名 | str | getInvoice |
key | Yes | APIキー | str | |
md5secret | Yes(1) | APIシークレットのmd5。(1)md5またはsha1のどちらかをセット | str | |
sha1secret | Yes(1) | APIシークレットのsha1。(1)md5またはsha1のどちらかをセット | str | |
nonce | Yes | 1以上の数、呼び出し毎に増分して送信してください | int | |
invoiceId | Yes | キャンセルしたいinvoiceId | str |
戻り値¶
- returnパラメータ
キー | 詳細 | 型 | 値または例 |
---|---|---|---|
invoiceId | 作成したインボイスを識別するためのID | str | 04e42516-1652-11e5-9eb4-4437e6999eec |
created | インボイス作成日時。unixtime | int | |
expired | インボイスの有効期限。unixtime | int | |
status | インボイスの状態 | str | canceled |
settled | 決済完了日時。unixtime | int | |
amount | 決済対象金額(送信された金額) | int | |
currency | 決済対象の暗号通貨 | str | btc または mona |
rate | 決済時の換算レート | int | |
btc | Bitcoinによる請求額(bitcoinによる決済時のみ) | int | |
mona | Monacoinによる請求額(monacoinによる決済時のみ) | int | |
address | BitcoinまたMonacoinの決済用支払先アドレス | str | |
BIP21 | bitcoinまたはmonacoinの支払いURI | str | |
speed | 決済スピード(送信されたものまたはデフォルトで適用されたもの | str | |
orderNumber | 送信された注文番号 | str |
キャンセル失敗時はエラーが帰るため、成功時のstatusは常に'canceled'となります