Byteballを使ったアプリやシステムを開発するための情報wikiです。現時点では管理人個人のメモとなっています。編集したい方はSlack経由でYamaokaまでご連絡下さい。

このページは以下のサイトを翻訳したものです。
https://github.com/byteball/byteball/wiki/Cashback...
英語が読める方は↑を直接ご覧ください。

概要

このAPIは、Byteballキャッシュバックプログラムに参加している加盟店および支払い処理業者用に提供されています。
お客様からの支払いを受け入れた後、このAPIを使用してお客様のキャッシュバックをリクエストします。

リクエストのフォーマット

まずリクエストは以下のURLに送信します。
メインネット:https://byte.money/new_purchase
テストネット:https://byte.money/test/new_purchase

次にパラメーターは以下の値を渡します
パラメーター名説明
partnerstringあなたがプログラムにサインアップしたときに割り当てられたパートナー名
partner_keystringリクエストの認証に使用されるパートナーキー
customerstringデータベースに顧客名やIDなどの購入を行った顧客のID。 このフィールドは、同じ顧客が別の購入をした場合に同じでなければなりません。
order_idstring購入に関連付けられた注文の一意のID。 同じ注文IDのキャッシュバックを再度要求しないでください。
descriptionstring購入の説明
merchantstringこのフィールドは、支払プロセッサーによってのみ個々のマーチャントを識別するために使用されます。 同じ商人から別の購入が行われた場合、これは同じでなければなりません。
addressstring顧客のバイトボールアドレスまたは電子メールアドレス。 キャッシュバックはこのアドレスに送られます。 電子メールアドレスの場合は、テキストコインが送信されます。 テキストコインが1週間以内に顧客に開かれない場合、報酬は戻ってしまいます。
currencystring購入に使用された通貨。 サポートされている通貨:USD、EUR、RUR、GBYTE、BTC。 購入が他の通貨で支払われた場合は、その額をサポートされている通貨のいずれか(GBYTEを除く)の金額に換算する必要があります。
currency_amountnumber購入額
partner_cashback_percentagenumber通常のキャッシュバックに加えて、自分の資金から顧客に支払う金額の割合。 Byteballは、ディストリビューションファンド(マーチャントマッチ)から同じパーセンテージを追加します。 デフォルトは0(追加の支払いなし)です。このオプションに資金を提供するには、事前に資金を入金しなければなりません。
purchase_unitstring(GBYTE支払い時のみ)支払い時のトランザクションID

レスポンスフォーマット

レスポンスはJSON形式です。
常にresultコンテナに含まれており、'ok'か’error’を返します。

キャッシュバックが顧客に正常に送信された場合、レスポンスは「"result": "ok"」となりキャッシュバックの額とユニットが以下の様に返信されます。
{"result":"ok","cashback_amount":101318,"unit":"kYbc5KGKB/KnjynYePEF4cpumKmOz22xVKSVWbmtZ0M="}

エラーの場合はレスポンスが「"result": "error"」となり、「error」フィールドに詳細が記されます。
{"result":"error","error":"authentication failed"}

コメントをかく


「http://」を含む投稿は禁止されています。

利用規約をご確認のうえご記入下さい

×

この広告は60日間更新がないwikiに表示されております。

当サイトは寄付歓迎です

Byteball
[1MB] [10MB] [100MB]

メニュー

メニュー



開発者ガイド

キャッシュバックプログラム

ウォレットを使用したユーザー認証(翻訳)
(調査中)JSON-RPC経由でByteballにアクセスする
コード解説(headless-byteballのstart.js)(作成中)

実用テクニック

【メニュー編集】

メンバーのみ編集できます