A client library for the BitPay API public facade.
This package communicates with BitPay using the BitPay REST API.
You can start using bitpay-public-client in any of these ways:
- via Bower: by running
bower install bitpay-public-clientfrom your console - or via NPM: by running
npm install bitpay-public-clientfrom your console.
npm i bitpay-public-client
ClientAPI constructor.
Create a new invoice. See https://bitpay.com/api#resource-Invoices.
Returns
On success:
Objectthe new invoice data.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
opts |
Object |
{} |
An object describing relevant specific options. |
callback |
Object |
{} |
Function called when request is complete. |
All required option attributes are described below. See https://bitpay.com/api#resource-Invoices for additional options.
| Attribute | Type | Default | Description |
|---|---|---|---|
opts.token |
string |
A BitPay API token. | |
opts.guid |
string |
A unique id. | |
opts.currency |
string |
ISO 4217 3-character currency code. | |
opts.price |
string |
The amount (in the specified currency) for which the invoice should be created. |
Retrieves exchange rates. Rates are exchange rates, representing the number of fiat currency units equivalent to one BTC. See https://bitpay.com/bitcoin-exchange-rates.
Returns
On success:
Objectthe table of rates or a single rate.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
opts |
Object |
{} |
An object describing relevant specific options. |
callback |
Object |
{} |
Function called when request is complete. |
All available option attributes are described below.
| Attribute | Type | Default | Description |
|---|---|---|---|
opts.currency |
string |
Empty, get all rates | ISO 4217 3-character currency code. |
Subscribes the device to receive push notifications.
Returns
On error:
Objectthe status of the subscribe request.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
opts |
Object |
{} |
An object describing relevant specific options. |
callback |
Object |
{} |
Function called when request is complete. |
All available option attributes are described below.
| Attribute | Type | Default | Description |
|---|---|---|---|
opts.subscriberId |
string |
A globally unique id used to identify a subscriber (e.g., email address). | |
opts.deviceType |
string |
The device type being subscribed, can be either android or ios. |
|
opts.deviceToken |
string |
The device token (e.g., APNS/GCM registration ID, obtained from a third-party service) to be used for push notification. |
Unsubscribes the device from receiving push notifications.
Returns
On error:
Objectthe status of the unsubscribe request.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
opts |
Object |
{} |
An object describing relevant specific options. |
callback |
Object |
{} |
Function called when request is complete. |
All available option attributes are described below.
| Attribute | Type | Default | Description |
|---|---|---|---|
opts.deviceToken |
string |
The device token (e.g., APNS/GCM registration ID, obtained from a third-party service) to be used for push notification. |
Retrieves a list of recently created invoices. The specified deviceToken is used to reference the subscriberId. If the subscriberId matches the buyer email field of one or more recently created invoices then the payment URL for each invoice is returned..
Returns
On success:
All available option attributes are described below.
| Attribute | Type | Default | Description |
|---|---|---|---|
paymentURLs |
array |
One URL for each pending point-of-sale payment (typically one) where you can pay the invoice(s). Only the BIP 72 protocol URL for payment resolution is returned. URLs are temporary and will change and not be available after 15 minutes when the invoice expires, unless the invoice has been paid. |
On error:
Objectthe status of the unsubscribe request.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
opts |
Object |
{} |
An object describing relevant specific options. |
callback |
Object |
{} |
Function called when request is complete. |
All available option attributes are described below.
| Attribute | Type | Default | Description |
|---|---|---|---|
opts.deviceToken |
string |
The device token (e.g., APNS/GCM registration ID, obtained from a third-party service) to be used for push notification. |
The MIT License
Copyright (c) 2016 BitPay
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.