Bitcoin Payment API

Bitwallet was designed from the ground up to be the most easy-to-use Bitcoin payment system possible. our bitcoin payment api is first Anonymous Bitcoin Payment Gateway without KYC / AML

BitWallet payment gateway provides you a secure way to accept bitcoin anonymously and sells goods and services. we provides a standards-based REST interface which enables application developers to interact in a powerful, yet secure way with their BitWallet account. Using the BitWallet API, clients can create and manage invoices, manage bills, retrieve real-time rates information, view merchant ledger entries, and much more. Developers may call the API directly over HTTPS using the language of their choice.

BitWallet merchants can set prices in any local currency or bitcoin. with our solution, each and every business owner can start accepting cryptocurrencies as a form of payment using our API or API-based ecommerce modules. Our gateway provides full automation for accepting Bitcoin anonymously, unique addresses for each order, real-time transparent exchange rates for customers, and a platform for merchants to track and manage their payment history and payouts.

API Overview

The body of the message must be JSON encoded and the content-type should be set to application/json. On successful creation, the invoice details will be provided in a JSON encoded response.

Each invoice valid for payment only 15 minutes.

Note: A merchant is restricted to creating no more than 50 invoices per day as default. if you need more invoice, please contact support to increase.

Note: Gateway key and Password must remain private and should only be accessible by the application developer/owner.

Requirements

The requirement for your site to connect the BitWallet payment system is only the activation of the CURL function. To ensure that this feature is active, contact your hosting support.

Step 1 - Create an Invoice

An invoice is created by sending an HTTP POST message to API URL with the details of the invoice passed in the body of the request.

API URL:
https://bitwallet.zone/service/invoice
Required POST Fields
Description Type Field
Gateway key (login to your account and click on Edit button in the page of my websites) string gateway_key
Password (login to your account and click on Edit button in the page of my websites) string password

Amount

The amount entered must have the following two conditions:

In Bitcoin type, it is not less than 0.000006 btc.

In currency type, it is not less than 0.10 USD.

double amount

Supported pricing currencies:

btc , usd , eur , gbp , cny , jpy , sgd , hkd , cad , nzd , aud , chf , rub

string type
Invoice Description (optional) - Maximum 50 character. string description
Customer see the button of "Back to seller's store" after payment completed. by click on this button come to callback URL and you should check invoice by API on that url. string callbackURL
value: create string action
Response:

If the information provided is correct:

	
// referenceNo = Invoice number to track
	
// invoice = Invoice number to display customer Or use in similar cases
	
// redirectURL = Your invoice url


{
  "status": 0,
  "data": {
    "referenceNo": "ZGePPYh8x",
    "invoice": "100017906",
    "redirectURL": "https://bitwallet.zone/invoice/ZGePPYh8x"
  }
}
            

In the event of an error:

{
  "status": 1,
  "data": []
}
            
Error code Description
-1 Request data is incorrect.
1 Gateway_key or password is wrong.
2 The amount entered is not correct.
3 The entered currency is not correct.
4 The callbackURL is not correct.
5 Server error.
6 You have reached your daily invoices limit.
7 invoice description (more than 50 character)
Step 2 - Redirect to payment page

If the information sent is correct in the previous step (Create an Invoice) and you have received the redirectURL value from the api, the user must forward the address to redirectURL.

Step 3 - Return after complete payment

Customer see the button of "Back to seller's store" after payment completed, by click on this button BitWallet send the following values by POST to the return address (callbackURL) you entered in the first step.

Description Type Field
Invoice number to track string referenceNo
Invoice status string status

Status parameter values

Value Description
expire This status indicates that the payment wasn't made within 15 minutes.
confirm This status indicates that the invoice has been paid, but need you check to sure confirmed on blockchain or not.
Step 4 - Get Transaction Details

With the API below, you can receive transaction details at any time. This function have limits for the number of request so it's better to use on the callbackURL page and after completing the third step use it to ensure your final invoice status. after than safely change the status of order on your website and deliverd the good or service to customer.

API URL :
https://bitwallet.zone/service/invoice
Required POST Fields
Description Type Field
Gateway key (login to your account and click on Edit button in the page of my websites) string gateway_key
Password (login to your account and click on Edit button in the page of my websites) string password
Invoice number to track string referenceNo
value: detail string action
Response:

If the information provided is correct:

	
// invoice = Invoice number to display customer Or use in similar cases
// btc = Only for your knowledge or use in certain cases
// rial = Only for your knowledge or use in certain cases
// usd = Only for your knowledge or use in certain cases

{
  "status": 0,
  "data": {
    "invoice": "100017906",
    "btc": "0.00001326",
    "rial": "0",
    "usd": "0.10",
    "status": "confirm"
  }
}

Status parameter values

Value Description
wait This status is used for freshly created payments.
pay This status indicates that the invoice has been paid, but payment is yet to be confirmed on the blockchain. NOTE: for final confirmed payment status, see: confirm.
expire This status indicates that the payment wasn't made within 15 minutes.
confirm This status indicates that the invoice has been fully paid and confirmed on the blockchain.

In the event of an error:

{
  "status": 1,
  "data": []
}
            
Error code Description
-1 Request data is incorrect.
1 Gateway_key or password is wrong.
2 Invoice was not found.

We Keep Your Data Safe And Secure

Create your account now and enjoy privacy and freedom!

Sign up in 10 seconds