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'となります