You can convert Bitcoins into gift cards
by sending an HTTP POST
request to
http://coincard.ndrix.com/api
with the following body parameters.
card_type |
amazon ,
bestbuy ,
dominos ,
papajohns ,
etc. See
the Gift Card drop down on the
order form for a complete list
|
---|---|
card_amount | The USD or BTC amount to be placed on the gift card |
currency |
The currency of the card_amount value.
One of btc or usd
|
Email address where the payment or gift card is sent.
Optional if dry_run is specified
|
|
dry_run |
Set to 1 if you want to see the order totals
but have no intention of completing the order
|
On success, you get a JSON response with a Bitcoin address and both USD and BTC amounts. Send BTC payment to the address specified within 2 minutes to complete the order.
{"btc":20.12, "usd":16.91, "btc_address":"127UjnJoegZ6PYCSpyGCBxYqPFB26EWAAk"}
If there's an error, you get a response something like this:
{"error":{"general":{"code":1,"message":"CoinCard is temporarily closed"}}}
It's also possible to get errors about specific API fields. These errors only happen when you have a malformed request. Since they shouldn't happen once your code is in production, error codes are not included.
{"error":{"card_type":"Unknown card type","email":"Required"}}
1 | CoinCard is currently down for maintenance |
---|---|
2 |
You sent a GET request but a POST
request is needed
|
3 | You tried placing an order lower than $1 |
4 | Insufficient funds. You can try a smaller amount or wait a few hours for funds to become available before trying the request again. |
5 |
You placed an order smaller than card_type
allows. For instance, Domino's has a minimum order of
$5.
|
6 |
You placed an order larger than card_type
allows. For instance, Domino's has a maximum order of
$100.
|
999 | CoinCard internal error. If you encounter this code, please email us the request details so that we can fix the problem. |