SpankPay
Search…
Welcome to the SpankPay SDK!
Get paid with crypto!
Overview
The SpankPay Merchant SDK makes it easy to get paid with cryptocurrency: easy for your users, and easy for you (the developer).
Getting started with SpankPay is a simple three-step process:
1. Include the SpankPay JavaScript
Add the following line to the bottom of the page on which you will be accepting payments:
1
<script src="https://pay.spankchain.com/spankpay.js"></script>
Copied!
2. Add a Pay with SpankPay button
Add the following code to create a button which will start a SpankPay payment. Alternatively, you can call the JavaScript API directly.
Button
JavaScript API
1
<button
2
data-spankpay-key="test_quickstart_key"
3
data-amount="69.69"
4
data-currency="USD"
5
data-accept-currencies="BOOTY,ETH,BTC,DOGE"
6
data-callback="https://pay.spankchain.com/api/quickstart/callback"
7
data-on-payment="onSpankPayPayment">
8
Pay with SpankPay!
9
</button>
10
​
11
<script>
12
function onSpankPayPayment(payment) {
13
console.log(`Payment ${payment.status}:`, payment)
14
}
15
</script>
Copied!
1
const { SpankPay } = require('spankpay')
2
​
3
SpankPay.showPurchase({
4
key: 'test_quickstart_key',
5
amount: '69.69',
6
currency: 'USD',
7
acceptCurrencies: ['BOOTY', 'ETH', 'BTC', 'DOGE'],
8
callback: 'https://pay.spankchain.com/api/quickstart/callback',
9
onPayment: function(payment) {
10
console.log(`Payment ${payment.status}`, payment)
11
},
12
})
Copied!
Want more control? SpankPay comes with a complete JavaScript API to give you full control of the payment process.
3. Generate an API key and write a Webhook endpoint
After you've evaluated SpankPay and would like to fully integrate it with your site, you will need to sign up for an account, create testing + production API keys, and implement a webhook endpoint which SpankPay will use to notify your application on a successful payment. This is covered in detail in Webhook Callbacks.
Integrating SpankPay
1. Include the SpankPay JavaScript
The first step in integrating SpankPay into your website is including the SpankPay JavaScript. This can be done directly with a
<script> tag:1
<script src="https://pay.spankchain.com/spankpay.js"></script>
Copied!
Or via
npm:1
$ npm install --save spankpay
Copied!
2. Create a Purchase
In SpankPay, a
Purchase is used to request payment from a user. Purchases can be created through either a SpankPay Button.1
<button
2
data-spankpay-key="test_quickstart_key"
3
data-amount="69.69"
4
data-currency="USD"
5
data-accept-currencies="BOOTY,ETH,BTC,DOGE"
6
data-callback="https://pay.spankchain.com/api/quickstart/callback"
7
data-on-payment="onSpankPayPayment">
8
Pay with SpankPay!
9
</button>
Copied!
Which will show the SpankPay payment page when the Pay with SpankPay! button is clicked, and call the
onSpankPayPayment callback once the payment has been completed and the webhook callback has been called.1
const { SpankPay } = require('spankpay')
2
​
3
SpankPay.showPurchase({
4
key: 'test_quickstart_key',
5
amount: '69.69',
6
currency: 'USD',
7
acceptCurrencies: ['BOOTY', 'ETH', 'BTC', 'DOGE'],
8
callback: 'https://pay.spankchain.com/api/quickstart/callback',
9
onPayment: function(payment) {
10
console.log(`Payment ${payment.status}`, payment)
11
},
12
})
Copied!
And For a complete description of each of these methods, including their different options, see the Purchase API.
3. Implement a Webhook Callback URL
When SpankPay receives confirmation of a user's payment, it will call the
callback webhook URL with a Payment to notify your application that the payment was completed successfully.1
POST /api/quickstart/callback
2
Content-Type: text/plain
3
X-SpankPay-Key: test_quickstart_key
4
X-SpankPay-Signature: t=1551389518&s=b613679a0814d9ec…
5
​
6
{
7
"type": "payment",
8
"paymentId": "pay_c493715653c",
9
"timestamp": "1969-06-09T06:09:06.969Z",
10
"purchaseId": "pur_f95d778c35f",
11
"purchase": { ... },
12
"amount": "69.69",
13
"amountCurrency": "USD",
14
"inputAmount": "0.6969",
15
"inputCurrency": "ETH",
16
"inputTx": "0x2144292c5ad…",
17
"receipt": {
18
"type": "webhook",
19
"url": "https://yoursite.com/yourserver/callback",
20
"status": "called",
21
"calledOn": "1969-06-09T06:09:06.969Z",
22
"responseStatusCode": 200,
23
"response": ...,
24
...
25
}
26
...
27
}
Copied!
For more, see:
4. Testing Your Integration
Testing API Keys
Every API key has a corresponding "testing" key. This testing key shares common settings (such as accepted coins) with the main key, but the currency list in the Purchase iframe will also include the option to pay with "test" versions of each coin.
When a test coin is selected, the user will be presented with a "send fake payment" button, which will immediately simulate a payment with that coin.
Test payments are identical to real payments, except the currencies will be prefixed with "TEST":
1
{
2
"amount": "69.69",
3
"amountCurrency": "TEST-USD",
4
"inputAmount": "0.6969",
5
"inputCurrency": "TEST-ETH",
6
...
7
}
Copied!
Note that the testing API key also uses a different secret key.
We recommend using the testing key in your development and staging environments.
Testing Webhooks
Last modified 3yr ago