JavaScript SDK Reference
Elepay
Kind: global class
- Elepay
- new Elepay(key, options)
- .handleCharge(charge) ⇒
Promise
- .handleSource(source) ⇒
Promise
- .createCodeWidget(options) ⇒
CodesWidget
- .checkout(code) ⇒
Promise
new Elepay(key, options)
SDKを初期化
Returns: Elepay
- Elepay インスタンス
Param | Type | Description |
---|---|---|
key | string | 必須 公開鍵 |
options | object | オプション |
options.locale | string | 言語設定。デフォルトはauto(ブラウザのロケールに応じて自動設定)で、他にja,en,zh-CN,zh-TWを指定できます。 |
elepay.handleCharge(charge) ⇒ Promise
Promise
Charge オブジェクトを渡して、支払い処理を行います。
Kind: instance method of Elepay
Returns: Promise
- 支払い処理結果のPromise。frontUrl設定必要の決済方法はfrontUrlで決済結果を戻ります。
Param | Type | Description |
---|---|---|
charge | object | 必須 サーバー側作成した Charge オブジェクト |
Example
elepay.handleCharge(chargeObject).then(function(result) {
// 正常処理
if (result.type === 'cancel') {
// 支払いキャンセル
} else if (result.type === 'success') {
// 支払い成功
}
}).catch(function(err) {
// エラー処理
})
elepay.handleSource(source) ⇒ Promise
Promise
Source オブジェクトを渡して、承認処理を行います。
Kind: instance method of Elepay
Returns: Promise
- 承認処理結果のPromise。frontUrl設定必要の決済方法はfrontUrlで承認結果を戻ります。
Param | Type | Description |
---|---|---|
source | object | 必須 サーバー側作成した Source オブジェクト |
Example
elepay.handleSource(source).then(function(result) {
// 正常処理
if (result.type === 'cancel') {
// キャンセル
} else if (result.type === 'success') {
// 承認成功
}
}).catch(function(err) {
// エラー処理
})
elepay.createCodeWidget(options) ⇒ CodesWidget
CodesWidget
EasyQRウィジェットを生成します
Kind: instance method of Elepay
Returns: CodesWidget
- EasyQRウィジェットインスタンス
Param | Type | Description |
---|---|---|
options | object | ウィジェットオプション |
options.container | string | 配置先のDOM要素のCSSセレクターを表す文字列 |
options.direction | string | ウィジェットレイアウト 縦:vertical(デフォルト) 横:horizontal |
options.icon | boolean | trueならブランドアイコン入りQRコードを表示。デフォルトはfalse |
options.parts.amount | boolean | trueなら金額を表示。デフォルトはtrue |
options.parts.paymentLogo | boolean | trueなら決済方法アイコンを表示。デフォルトはtrue |
options.parts.tip | boolean | trueならヘルプメッセージを表示。デフォルトはtrue |
options.theme.primaryColor | boolean | メイン色 |
options.theme.borderColor | boolean | ウィジェット罫線色。null:罫線なし |
options.theme.backgroundColor | boolean | ウィジェット背景色。デフォルトは白 |
Example
var widget = elepay.createCodeWidget({
container: '#widget'
})
widget.on('success', () => {
// 決済完了後処理
})
widget.on('expired', () => {
// 新しいEasyQRコードを生成するなと
})
widget.show('cod_028123beb9f8c853fa845f4')
elepay.checkout(code) ⇒ Promise
Promise
EasyCheckout 処理を行います。
Kind: instance method of Elepay
Returns: Promise
- Checkout処理のPromise。エラーの場合だけ、処理する必要があります。
Param | Type | Description |
---|---|---|
code | object | 必須 サーバー側作成した EasyQR オブジェクトID |
Example
elepay.checkout('cod_028123beb9f8c853fa845f4').catch(function(err) {
// エラー処理
})
CodesWidget
EasyQRウィジェットクラス
Kind: global class
codesWidget.show(code)
EasyQRウィジェットを表示します
Kind: instance method of CodesWidget
Param | Type | Description |
---|---|---|
code | string | 必須 サーバー側作成した EasyQR オブジェクトID |
Example
widget.show('cod_028123beb9f8c853fa845f4')
codesWidget.destroy()
EasyQRウィジェットを破棄します
Kind: instance method of CodesWidget
"success" (ev, codeObject)
支払完了イベント
Kind: event emitted by CodesWidget
Param | Type | Description |
---|---|---|
ev | object | イベント |
ev.type | string | success |
codeObject | object | EasyQRコードオブジェクト |
Example
widget.on('success', function (ev, codeObject) {
// 決済完了後処理
})
"expired" (ev, codeObject)
EasyQRコード期限切れイベント
Kind: event emitted by CodesWidget
Param | Type | Description |
---|---|---|
ev | object | イベント |
ev.type | string | expired |
codeObject | object | EasyQRコードオブジェクト |
Example
widget.on('expired', function (ev, codeObject) {
// 新しいEasyQRコードを生成するなと
})
"error" (ev, error)
エラーイベント
Kind: event emitted by CodesWidget
Param | Type | Description |
---|---|---|
ev | object | イベント |
ev.type | string | error |
error | Error | エラーオブジェクト |
Example
widget.on('error', function (ev, err) {
// エラー処理
})
Updated over 1 year ago