@accept-banano/client 中文文档教程
accept-banano-client
accept-banano-client 是一个 JavaScript 包,可帮助您与 进行通信accept-banano 用于在您的客户端应用程序中轻松接收 BANANO 付款。
Installation
via NPM
npm install @accept-banano/client
yarn add @accept-banano/client
ES Modules / TypeScript
import * as acceptBanano from '@accept-banano/client'
CommonJS
const acceptBanano = require('@accept-banano/client')
Directly in Browser, as a UMD module
accept-banano-client 脚本加载后会有一个名为 acceptBanano 的全局变量,您可以通过 window.acceptBanano
访问
<html>
<head>
...
<script src="https://unpkg.com/@accept-banano/client@2"></script>
</head>
...
</html>
Usage
Creating a Payment Session
它能够启动支付流程,您必须创建一个新的支付会话
// 1- create a new payment session
type CreateSessionParams = {
apiHost: string // host of your Accept BANANO server, without protocol
pollInterval?: number // time interval (ms) to re-check for verification of a payment (default: 3s)
debug?: boolean // enables debug mode and prints some useful stuff to console
}
const session = acceptBanano.createSession({
apiHost: 'accept-nano-demo.put.io',
})
// 2- register event listeners to shape-up your logic based on session events.
type PaymentSessionEvents = {
start: () => void
end: (error: PaymentError | null, payment: AcceptBananoPayment | null) => void
}
session.on('start', () => {
myApp.paymentStarted()
})
session.on('end', (error, payment) => {
if (error) {
return myApp.paymentFailed({ reason: error.reason })
}
return myApp.paymentSucceeded({
amount: payment.amount,
state: payment.state,
})
})
Presenting the Payment Overlay
。创建会话并附加事件侦听器后,您可以按照其中一个选项继续支付流程。
Option 1: Create a Payment Through Client
如果您想在您的客户端应用程序中创建并验证 accept-banano 付款,您可以使用此选项。
创建付款后,accept-banano-client 将自动进行验证步骤。
type CreatePaymentParams = {
amount: string // stringified number
currency: 'BANANO' | 'USD'
state?: string // payload to share between your client and server, will be embedded into the payment object
}
session.createPayment({
amount: '1',
currency: 'USD',
state: '{userId:7}',
})
Option 2: Verify a Payment Through Client
如果您在另一个上下文(例如您的应用程序的后端)中创建一个accept-banano 支付,您可以使用此选项在您的客户端应用程序中执行验证。
type VerifyPaymentParams = {
token: string // the Accept BANANO payment token created in your backend application
}
session.verifyPayment({ token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' })
Contributing
- Please open an issue if you have a question or suggestion.
- Don't create a PR before discussing it first.
Who is using accept-nano-client in production?
- Me
如果 accept-banano 正在帮助您接收 BANANO 付款,请发送 PR 以列出您的网站。
accept-banano-client
Payment gateway for BANANO
accept-banano-client is a JavaScript package that helps you to communicate with accept-banano for receiving BANANO payments easily in your client-side applications.
Installation
via NPM
npm install @accept-banano/client
yarn add @accept-banano/client
ES Modules / TypeScript
import * as acceptBanano from '@accept-banano/client'
CommonJS
const acceptBanano = require('@accept-banano/client')
Directly in Browser, as a UMD module
After the accept-banano-client script is loaded there will be a global variable called acceptBanano, which you can access via window.acceptBanano
<html>
<head>
...
<script src="https://unpkg.com/@accept-banano/client@2"></script>
</head>
...
</html>
Usage
Creating a Payment Session
To be able to initiate the payment process, you must create a new payment session.
// 1- create a new payment session
type CreateSessionParams = {
apiHost: string // host of your Accept BANANO server, without protocol
pollInterval?: number // time interval (ms) to re-check for verification of a payment (default: 3s)
debug?: boolean // enables debug mode and prints some useful stuff to console
}
const session = acceptBanano.createSession({
apiHost: 'accept-nano-demo.put.io',
})
// 2- register event listeners to shape-up your logic based on session events.
type PaymentSessionEvents = {
start: () => void
end: (error: PaymentError | null, payment: AcceptBananoPayment | null) => void
}
session.on('start', () => {
myApp.paymentStarted()
})
session.on('end', (error, payment) => {
if (error) {
return myApp.paymentFailed({ reason: error.reason })
}
return myApp.paymentSucceeded({
amount: payment.amount,
state: payment.state,
})
})
Presenting the Payment Overlay
After creating your session and attaching the event listeners, you can follow one of those options to proceed with the payment flow.
Option 1: Create a Payment Through Client
If you want to create and verify an accept-banano payment in your client application, you can use this option.
After the payment is created, accept-banano-client will automatically proceed to the verification step.
type CreatePaymentParams = {
amount: string // stringified number
currency: 'BANANO' | 'USD'
state?: string // payload to share between your client and server, will be embedded into the payment object
}
session.createPayment({
amount: '1',
currency: 'USD',
state: '{userId:7}',
})
Option 2: Verify a Payment Through Client
If you create an accept-banano payment in another context (such as your application's backend), you can use this option to perform the verification in your client application.
type VerifyPaymentParams = {
token: string // the Accept BANANO payment token created in your backend application
}
session.verifyPayment({ token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' })
Contributing
- Please open an issue if you have a question or suggestion.
- Don't create a PR before discussing it first.
Who is using accept-nano-client in production?
- Me
Please send a PR to list your site if accept-banano is helping you to receive BANANO payments.