- Introduction
- How it works?
- Get Started
- Development
Wecolme to iPint! For merchants and businesses accepting payments is limited to 'fiat currencies' through traditional means. Traditional method are costly, inefficient and risk prone. They are geographically restrictive.
iPint allows businesses to accept crypto payments by its secure, easy to use and easy to integrate payment service.
Customer selects cryptocurrency as payment method.
Customer selects specific coin & amount of USD to be deposited. QR code/invoice generated with amount & address. Transfers crypto within time limit.
Payment is confirmed on blockchain. Customer gets deposit in his account. Merchant is informed in realtime. Merchants settlement happens in USDT.
Check Demo
Complete registration process at https://dashboard.ipint.io/register/
Once your account get activated, API Credentials will be shared on the registered email address.
Check Integration Options
Complete registration process at https://dashboard.ipint.io/register/
Once your account get activated, API Credentials will be shared on the registered email address.
Once PSP account gets verified, PSP can onboard merchant
It requires
-
merchant’s confirmation that merchant is agree with iPint’s Terms of Service, Privacy Policy and AML/CFT Policy
-
merchant’s confirmation that PSP can share merchant’s kyc details with iPint
-
confirmation that PSP has done KYC/AML check on merchant
-
merchant’s kyc details to be shared with iPint
-
merchant fee (%) to be charged from merchant
-
merchant’s kyc documents
a. Proof of Business Entity: Company's registration document such as Certificate of Incorporation or business license issued by the government.
b. Proof of Business Address: Current utility bill or business lease/ rental agreement.
c. Photo ID of Beneficial Owner: Passport or National ID.
d. Bank Statement: 3 Months bank statements to be submitted.
e. Tax ID documents: EIN Verification document, IRS letter or W9 form, or previously filed tax return form. [ For US, Netherlands & German Merchants]
For requirements in above 5 points, you need to call /aggregator/merchants endpoint
To share merchant’s kyc documents, get aws s3 link from /merchant/account endpoint.
Provide Merchant's Settlement Info at /preferences endpoint.
Check Integration Options
-
Fully customizable integration into any online shop or website.
To integrate with this option you need to call iPint’s secure APIs. API Doc : https://ipint.io:8010/docs/#/Merchant
-
Simple to implement, open in iPint secure page. You just need to redirect on iPint’s checkout page.
To open iPint's checkout page, you need to call /checkout endpoint with HTTP POST Method, you will get 'payment_process_url' in response, just redirect on it.
As mentioned in API Reference, use Mainnet Base URL (https://api.ipint.io:8003/) for production. To start with integration and testing purpose, use Testnet Base URL(https://api.ipint.io:8002/)
-
Displaying within your web page. For this option, you need to add the code given as below on your website.
<iframe width="1270" height="740" src="payment_process_url-from-checkout-endpoint"></iframe>Example
<iframe width="1270" height="740" src="https://ipint.io/checkout?id=voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8"></iframe> -
Instant setup for your WooCommerce store. Find the plugin here.
Before testing with actual crypto, make sure you have tested the complete payment process on testnet with testnet coins. In order to test, you need to have a wallet app on your phone which has testnet coins.
- We recommend Coinomi wallet for testnet. Please download it from here https://www.coinomi.com/en/downloads/
- After downloading wallet, you need to fill this with testnet bitcoin. For receiving testnet bitcoins you can search for any faucet (this one looks good https://coinfaucet.eu/en/btc-testnet) and get testnet bitcoins. Please use your testnet bitcoin receiving address of coinomi wallet (add 'Bitcoin Test' from the list of coins). Once your wallet has testnet bitcoin, you can make payments to invoices which you generate by scanning QR code with your coinomi wallet app.
You can check this article to understand how to test iPint on testing environement (use testnet)?
- All endpoints return either a JSON object or array.
- In case of POST method, request data will be JSON
- Mainnet Base URL https://api.ipint.io:8003 (Use in Production)
- Testnet Base URL https://api.ipint.io:8002 (Use for testing and integration purpose)
To get 'payment_process_url' and redirect on it to open iPint's checkout page
-
/checkout
-
POST
-
apikey: your-api-key
-
None
-
Required: client_email_id, client_preferred_fiat_currency, merchant_website
Conditional: merchant_id, to be used if B2B
Optional: amount
{ "client_email_id": "client-email-address-for-unique-reference-id", "client_preferred_fiat_currency": "local-currency-code", "amount": "amount-in-local-currency-upto-two-decimal-places", "merchant_id": "ipint-merchant-id", "merchant_website": "redirect-url-of-the-page-where-you-want-to-redirect-the-customer-after-payment", "invoice_callback_url": "to get callback when payment status gets changed" }curl sample request
curl --location --request POST 'https://api.ipint.io:8003/checkout' \ --header 'apikey: your-api-key' \ --header 'Content-Type: application/json' \ --data-raw '{ "client_email_id": "[email protected]", "client_preferred_fiat_currency": "INR", "amount": "4999.65", "merchant_website": "https://merchant.redirect", "invoice_callback_url": "https://merchant.web/callback" }' -
Code: 200
{"session_id":"id-to-be-fetched-in-the-url-to-redirect-to-ipint", "payment_process_url":"payment-process-url"}sample response
For Mainnet (if you are using mainnet base url https://api.ipint.io:8003/)
{"session_id":"voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8","payment_process_url":"https://ipint.io/checkout?id=voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8"}For Testnet (if you are using testnet base url https://api.ipint.io:8002/)
{"session_id":"voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8","payment_process_url":"https://ipint.io/test-checkout?id=voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8"}Note: Use this id to get status after the payment (call /invoice endpoint)
-
Code: 400
{"error": true, "message": "error-messsage"}
To get payment status and details. Use the id that you got from the /checkout endpoint.
-
/invoice
-
GET
-
content-type: application/json
apikey: your-api-key
signature: hmac-signature-using-your-api-secret
nonce: current-unix-time
-
id : the id you got from /checkout endpoint
-
None
curl sample code
curl --location --request GET 'https://api.ipint.io:8003/invoice?id=id-from-the-response-of-checkout-endpoint' \
--header 'content-type: application/json' \
--header 'apikey: your-api-key' \
--header 'signature: hmac-signature-using-your-api-secret' \
--header 'nonce: current-unix-time'
sample response
{'data': {'blockchain_confirmations': '0/6',
'blockchain_transaction_status': 'PENDING',
'depositor_email_id': '[email protected]',
'invoice_amount_in_local_currency': '4999.65',
'invoice_amount_in_usd': '67.58',
'invoice_creation_time': '1633960704',
'invoice_crypto_amount': '0.11065324',
'invoice_id': 'voZ3pYmiE16FLaSfFmytouwFfcjR4Zom8',
'local_currency_code': 'INR',
'received_amount_in_local_currency': '4999.65',
'received_amount_in_usd': '67.58',
'received_crypto_amount': '0.11065324',
'transaction_crypto': 'BCH',
'transaction_hash': '',
'transaction_onclick': '',
'transaction_status': 'CHECKING',
'transaction_time': '',
'wallet_address': 'qrk2dnecws4c6fm2av0mkuf5g4d4wm7lrcr0k2lmrh'},
'user_data': {'company_name': 'merchant-name',
'depositor_id': '[email protected]',
'email_id': '[email protected]',
'website': '#'}}
Note :
-
To mark customer's payment, see transaction_status in the response from /invoice (GET).
CHECKING means checking for transation on blockchain
PROCESSING means transaction hit blockchain but confirmations are less than 3, see blockchain_confirmations in the response
COMPLETED means transaction is completed, you can mark the payment successful. If you get this status, do not query further.
FAILED means customer didn't pay the invoice or transaction is pending on blockchain, see blockchain_transaction_status in the response. If you get this status, do not query further.
CANCELLED means customer didn't complete payment and closed process before qr code is generated. If you get this status, do not query further.
-
To check whether invoice is full in paid, compare invoice_amount_in_local_currency, invoice_amount_in_usd, invoice_crypto_amount with received_amount_in_local_currency, received_amount_in_usd, received_crypto_amount respectively
-
Invoice Callback is HTTP POST message sent from the iPint server to the merchant’s server.The primary purpose of callback is to alert the merchant’s server that the status of an invoice has changed.
i. HTTP POST Message (JSON) is to be sent to the invoice_callback_url provided by merchants when creating the invoice by calling /checkout endpoint.
ii. It is sent for the invoice statuses COMPLETED, FAILED
iii. The body consists keys invoice_id and status
iv. Make sure to not rely on whitelisting iPint’s sending IP addresses, as these IP addresses are subject to change without notice.
v. Make sure to use HTTPS for your invoice_callback_url.
vi. iPint does not send a signed request, so the information in the body should not be trusted outright. It shall be used as a trigger to verify the status of a specific invoice. This is to be done via the GET /invoices endpoint since the invoice_id is provided in the body of invoice callback.
vii. The iPint server expects an HTTP 200 response with an empty body. Any other HTTP response is considered by iPint as a failed delivery. The iPint server attempts to send request on the invoice_callback_url multiple times until the send is either successful or the iPint server gives up.
To onboard a merchant of an aggregator
-
/aggregator/merchants
-
POST
-
content-type: application/json
apikey: your-api-key
signature: hmac-signature-using-your-api-secret
nonce: current-unix-time
-
None
-
All the details are of your merchant business.
Sample Data
{ "legal_name_of_business": "Legal Name of Merchant Business", "business_registration_country": "Name of Country of Merchant Business Registration", "legal_status_of_business": "e.g. Sole Trader", // options: Sole Trader, Partnership, Incorporated Company, Government Organization, Non-Profit "business_type": "e.g. B2B", // options: B2B, B2C, Both "industry": "e.g. Financial Services", // you can check at https://api.ipint.io:8003/industries "annual_revenue": "e.g. $ 0-1 Million", // options: $ 0-1 Million, $ 1-25 Million, $ 25-100 Million, $ More than 100 Million "trade_name_of_service": "Trade Name of Merchant Business", "business_registration_number": "Business Registration Number", "main_business_activity": "Main Activity of Business", "target_website": "Website where API to be used", "date_of_incorporation": "Date of Merchant Company Incorporation", // Date format : YYYY-MM-DD "expected_maximum_amount_single_transaction": "e.g.10000", // in usd "expected_yearly_transaction_volume": "e.g.10000000", // in usd "merchant_tool": "API", "legally_registered_business_address": { "house_number": "e.g.23", "street_name1": "e.g.near saw mill", "street_name2": "e.g.Lotus Vihar", "city": "e.g.Philadelphia", "state": "e.g.Pennsylvania", "postal_code": "e.g.19092" }, "contact": { "phone_number": "e.g.79832689342", "country_phone_code": "e.g.+1", "website": "e.g.abc.co", "support_email": "[email protected]", "notification_email": "[email protected]" }, // Merchant Business Beneficial Owner Info "business_beneficial_owner": { "first_name": "First Name", "last_name": "Last Name", "date_of_birth": "Date of Birth", // Date Format : YYYY-MM-DD "relation_with_organization": "e.g. Managing Director/CEO", // options: Managing Director/CEO, Director, Promoter, Principal, Other "other_relationship": "mention other relationship", // if Other "email": "[email protected]", "country_phone_code": "e.g.+91", "phone_number": "e.g.7835211996" }, "merchant_fee": "fee (in percentage, int or float value) to be charged from merchant", "is_merchant_kyc_done_by_psp": "YES", // confirmation by aggregator "can_psp_share_merchant_data_with_ipint": "YES", // confirmation by merchant - "We agree that you can share our 'Merchant KYC Details' with iPint." "is_merchant_agreed_with_ipint_policies": "YES" // confirmation by merchant - "We agree with iPint's Terms of Service (https://ipint.io/terms-services.html), Privacy Policy (https://ipint.io/privacy-policy.html) and AML/CFT Policy (https://ipint.io/aml-cft-policy.html)." } -
{"message": "OK", "merchant_id": "Merchant ID"}
-
{"error": true, "message": "description for error"}
To share merchant’s kyc documents, get aws s3 link. Get a new link to share each document.
-
/merchant/account
-
GET
-
content-type: application/json
apikey: your-api-key
signature: hmac-signature-using-your-api-secret
nonce: current-unix-time
-
id : Merchant ID
key : filename e.g. Proof of Business Entity
-
None
-
{"presigned_url": presigned url to upload a single document}
-
{"error": true, "message": "description for error"}
To provide settlement info for a merchant of an aggregator
-
/preferences
-
POST - to be called only once per merchant to add settlement info
PUT - to update merchant settlement info
-
content-type: application/json
apikey: your-api-key
signature: hmac-signature-using-your-api-secret
nonce: current-unix-time
-
None
-
Merchant wallet details to do settlement.
Sample Data
{ "merchant_id": "Merchant ID", "settlement_accounts": [ { "wallet_title": "My USDT Wallet", "address": "0x00556a16efc8bbfa9cd462c4ae31bee126efcba2", "currency": "USDT", "percentage": "100%" } ], "settlement_cycle": "Weekly" // options: Daily, Weekly, Monthly } -
{"message": "OK"}
-
{"error": true, "message": "description for error"}
To update profile data of a merchant of an aggregator
-
/settings
-
PUT
-
content-type: application/json
apikey: your-api-key
signature: hmac-signature-using-your-api-secret
nonce: current-unix-time
-
None
-
Merchant profile data to do update.
Request Data
{ "merchant_id": "Merchant ID", "business_type": "e.g. B2B", // options: B2B, B2C, Both "country_phone_code": "+91", "phone_number": "9998887776", "support_email": "e.g. [email protected]", "notification_email": "e.g. [email protected]", "annual_revenue": "e.g. $ 0-1 Million", // options: $ 0-1 Million, $ 1-25 Million, $ 25-100 Million, $ More than 100 Million "industry": "e.g. Financial Services", // you can check at https://api.ipint.io:8003/industries "trade_name_of_service": "Trade Name of Merchant Business", "website": "e.g.abc.co", "expected_maximum_amount_single_transaction": e.g.100000, "expected_yearly_transaction_volume": e.g. 10000000 } -
{"message": "OK"}
-
{"error": true, "message": "description for error"}
Check this directory for java code
const CryptoJS = require('crypto-js') // Standard JavaScript cryptography library
const request = require('request')
const apiKey = 'paste key here'
const apiSecret = 'paste secret here'
const apiPath = '/say' // Example path
//const apiPath = '/say?id=123' // Example path with query params
const nonce = (Date.now() * 1000).toString() // Standard nonce generator. Timestamp * 1000
const body = {} // Field you may change depending on endpoint
let signature = '/api/' + nonce + apiPath // GET method
// let signature = '/api/' + nonce + apiPath + JSON.stringify(body) // POST method
// Consists of the word api as it is and then nonce, api path and request body
// if api method is GET, also add query params along with the api path if any and do not add body
console.log(signature)
const sig = CryptoJS.HmacSHA384(signature, apiSecret).toString()
// The authentication signature is hashed using the private key
console.log(sig)
const options = {
url: 'https://api.ipint.io:8003'+apiPath,
headers: { 'nonce': nonce, 'apikey': apiKey, 'signature': sig }, body: body, json: true }
console.log(options)
// to call GET method
request(options, function (error, response, body) {
// Logs the error if one occurred
console.error('error:', error);
// Logs the response status code if a response was received
console.log('statusCode:', response && response.statusCode);
// Logs the response body
console.log('body:', body);
});
// // to call POST method
// request.post(options, (error, response, body) => { // // Logs the error if one occurred
// console.error('error:', error);
// // Logs the response status code if a response was received
// console.log('statusCode:', response && response.statusCode);
// // Logs the response body
// console.log(body);
//})
import hashlib
import hmac
import json
import requests
import time
BASE_URL = "https://api.ipint.io:8003" # mainnet
# BASE_URL = "https://api.ipint.io:8002" # testnet
API_KEY = "your ipint api key"
API_SECRET = "your ipint api secret"
NONCE = str(int(time.time()))
class TestiPint:
def __init__(self, api_key=API_KEY, api_secret=API_SECRET, base_url=BASE_URL, nonce=NONCE):
self.apikey = api_key
self.apisecret = api_secret
self.nonce = nonce
self.baseurl = base_url
def hmacsha384(self, message):
inp = message.encode()
secret = self.apisecret.encode()
digest_maker = hmac.new(secret, inp, hashlib.sha384)
res = digest_maker.hexdigest()
return res
def get_headers(self, api_path, body=None):
print("\nfunction get_header received params: ")
print("\napi_path: ", api_path)
print("\nbody: ", body)
nonce = self.nonce
if body:
signature = "/api/{}{}{}".format(nonce, api_path, json.dumps(body))
else:
signature = "/api/{}{}".format(nonce, api_path)
print("\nsignature ", signature)
sig = self.hmacsha384(signature)
headers = {
'nonce': nonce,
'apikey': self.apikey,
'signature': sig,
'content-type': "application/json"
}
return headers
def ping(self):
api_path = '/say'
url = self.baseurl + api_path
print("\napi url ", url)body = {}
headers = self.get_headers(api_path, body)
res = requests.get(url, headers=headers)
print(res.status_code)
print(res.text)
print(res.json())
def onboard_client(self, client_email_id, client_preferred_fiat_currency='INR'):
api_path = '/onboard'
url = self.baseurl + api_path
print("\napi url ", url)
body = {
"client_email_id": client_email_id,
"client_preferred_fiat_currency": client_preferred_fiat_currency
}
headers = self.get_headers(api_path, body)
json_body = json.dumps(body)
res = requests.post(url=url, data=json_body, headers=headers)
print(res.status_code)
print(res.text)
print(res.json())
def get_invoice(self, invoice_id, hist=False):
api_path = '/invoice?id={}'.format(invoice_id)
if hist:
api_path += '&hist=true'
url = self.baseurl + api_path
body = {}
headers = self.get_headers(api_path, body)
res = requests.get(url, headers=headers)
print(res.status_code)
print(res.text)
print(res.json())
return res.json()