Test Coin Payment Solutions
This documentation explains about API request and response. All dates in any API response are based on the UTC timezone.
If you want use our plugins, you can check out Coinremitter: Crypto payment gateway on the GitHub account
Pass header data in every API "Accept:application/json", However it is optional
All API has a rate limit, the free plan has a rate limit of 100, and the Pro plan has a rate limit of 500. Make sure you are checking x-ratelimit-remaining and x-ratelimit-limit response header of API. When you exceed rate limit you will get "Too Many Attempts" response with "429" http status code . Rate limit will reset after every 1 minute. it means if you have free plan, you can call 100 apis per minute. you can upgrade plan from your dashboard to increase rate limit or if you want to increase rate limit greater than 500, you can contact us
All API call require API key and password. How to get my API Key and Password ?
Types of Flags
Flag Value |
Meaning |
Example |
Description |
---|
1
|
Operation Success
|
|
The operation has been completed successfully and you will get response code 200. However, if you want to see the expected result then you may check the data parameter of the response. For example validate-address : If the address is correct then you will get Flag 1 wheather valid parameter in data is true or false. get-transaction : If the transaction is successful, then its flag will be 1. But it does not mean that your transaction has been confirmed. To check the confirmation of your transaction, you need to check it confirmation key-value under the data object. |
0
|
Operation Fail
|
|
Flag 0 means your operation has been failed. As a result, you will get a response of 200 or 500. For example You will get the Flag 0 with the response code 200 if the API key or password is false. If there are internal server errors then you will get the Flag 0 with the 500 HTTP status code. |
2
|
Validation Error
|
|
If the required field is blank or unset then you will get Flag 2. Validation error will be found even if the format of the amount is wrong. For example If you pass 1,000 in the amount then as a consequence you will get the validation error because there is comma in amount |
Create New Wallet Address
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API key |
passwordRequired |
string
|
123456 |
Wallet Password |
labelOptional |
string
|
my_label |
Label of New Address |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
New address created successfully. |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||
It is data object
|
POST Create New Wallet Address https://coinremitter.com/api/v3/TCN/get-new-address
Parameter
api_key :
password :
label :
{"flag":1,"msg":"New address created successfully .","action":"get-new-address","data":{"address":"MMtU5BzKcrewdTzru9QyT3YravQmzokh","label":"my_label","qr_code":"https://coinremitter.com/qr/tcn/image.png"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-new-address
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form label=' '
Validate Address
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
addressRequired |
string
|
MLjDMFsob8gk9EX6tj8KUKSpmHM6qG2qFK |
Address which you want to validate. |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
Success ! |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||
It is data object
|
POST Validate Address https://coinremitter.com/api/v3/TCN/validate-address
Parameter
api_key :
password :
address :
{"flag":1,"msg":"Success !","action":"validate-address","data":{"valid":true}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/validate-address
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form address=' '
Withdraw
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
to_addressRequired |
string
|
MLjDMFsob8gk9EX6tj8KUKSpmHM6qG2qFK |
Address of in which you want to send amount |
amountRequired |
string
|
2 |
Total amount which you want to send |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
Amount Successfully Withdraw. |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
||||||||||||||||||||||||||||||||||||
It is data object
|
POST Withdraw https://coinremitter.com/api/v3/TCN/withdraw
Parameter
api_key :
password :
to_address :
amount :
{"flag":1,"msg":"Amount Successfully Withdraw.","action":"withdraw","data":{"id":"5b5ff10a8ebb830edb4e2a22","txid":"1147aca98ced7684907bd469e80f7482f40a1aaf75c1e55f7a60f725ba28","explorer_url":"http://coin-explorer-url/1147aca98ced7684907bd46......","amount":2,"transaction_fees":"0.00002000","processing_fees":"0.00460000","total_amount":"2.00462","to_address":"MLjDMFsobgk9Etj8KUKSpmHM6qG2qFK","wallet_id":"5c42a0ab846fe75142cfb2","wallet_name":"my-wallet","coin_short_name":"TCN","date":"2019-06-02 01:02:03"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/withdraw
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form to_address=' '
--form amount=' '
Get Transaction
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
idRequired |
string
|
5b7e6f7d5aa55854e5726ac2 |
Unique id of your Transaction |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||||||||||||||||||||||||||||||||||||||
It is data object
|
POST Get Transaction https://coinremitter.com/api/v3/TCN/get-transaction
Parameter
api_key :
password :
id :
{"flag":1,"msg":"success","action":"get-transaction","data":{"id":"5b5ff10a8ebb830edb4e2a22","txid":"c4b853d4be7586798870a4aa766e3bb781eddb24aaafd81da8f66263017b872d","explorer_url":"http://coin-explorer-url/c4b853d4be7586798870a4aa7...","type":"send","merchant_id":"5ef04e355b10c01d5436f0c2","coin_short_name":"TCN","wallet_id":"5f8a6fd164b6e25a78545e02","wallet_name":"my-wallet","address":"0xe82f1bea5e9d80edab36083013699895e6aa307d","amount":"2","confirmations":0,"date":"2020-10-22 15:32:11","transaction_fees":"0.00002000","processing_fees":"0.00460000","total_amount":"2.00462"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-transaction
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form id=' '
Get Transaction By Address
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
addressRequired |
string
|
MLjDMFsob8gk9EX6tj8KUKSpmHM6qG2qFK |
Address |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
||||||||||||||||||||||||||||||||||||
It is data object
|
POST Get Transaction By Address https://coinremitter.com/api/v3/TCN/get-transaction-by-address
Parameter
api_key :
password :
address :
{"flag":1,"msg":"success","action":"get-transaction-by-address","data":[{"id":"5b7650458ebb8306365624a2","txid":"7a6ca109c7c651f9b70a7d4dc8fa77de322e420119c5d2470bce7f08ba0cd1d6","explorer_url":"http://coin-explorer-url/exp/7a6ca109c7c651f9b70a7d4dc8fa7...","merchant_id":"5bc46fb28ebb8363d2657347","type":"receive","coin_short_name":"TCN","wallet_id":"5c42ea0ab846fe751421cfb2","wallet_name":"my-wallet","address":"MP78UQoDpkehY7mMy2Cn9HSfysz4wbCeN1","amount":"2","confirmations":3,"date":"2018-08-17 10:04:13"},{"id":"23sdew232158ebb8306365624a2","txid":"7a6ca109c7c651f9b70fdgfg44er34re7de322e420119c5d2470bce7f08ba0cd1d6","explorer_url":"http://coin-explorer-url/exp/2322ereer344c7c651f9b70a7d4dc8fa7...","merchant_id":"3434df4w28ebb8363d2657347","type":"receive","coin_short_name":"TCN","wallet_id":"5c42ea0ab846fe751421cfb2","wallet_name":"my-wallet","address":"MP78UQoDpkehY7mMy2Cn9HSfysz4wbCeN1","amount":"1","confirmations":2,"date":"2018-08-17 10:05:13"}]}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-transaction-by-address
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form address=' '
Get Wallet Balance
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$8He07BlQm5SFyTNQVxwHM.7KW0q4Oaplw4i.8rDUldIxHbzBz7Rfu |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
Get balance successfully |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||
It is data object
|
POST Get Wallet Balance https://coinremitter.com/api/v3/TCN/get-balance
Parameter
api_key :
password :
{"flag":1,"msg":"Get balance successfully","action":"get-balance","data":{"balance":0.2457,"wallet_name":"my-wallet","coin_name":"Test Coin"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-balance
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
Create Invoice
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
amountRequired |
string
|
2 |
Invoice Amount |
nameOptional |
string
|
random name |
Name which you want to see on Invoice |
currencyOptional |
string
|
EUR |
Invoice amount currency |
expire_timeOptional |
string
|
10 |
Invoice expiry time in minutes. |
notify_urlOptional |
string
|
http://yourdomain.com/notify-url |
URL on which you will be notify about payment |
success_urlOptional |
string
|
http://yourdomain.com/success-url |
After payment done url redirect to success url |
fail_urlOptional |
string
|
http://yourdomain.com/fail-url |
On payment fail url redirect to fail url |
descriptionOptional |
string
|
Hello world |
Invoice description |
custom_data1Optional |
string
|
custom_data1 |
custom_data1 |
custom_data2Optional |
string
|
custom_data2 |
custom_data2 |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
It is data object
|
POST Create Invoice https://coinremitter.com/api/v3/TCN/create-invoice
Parameter
api_key :
password :
amount :
name :
currency :
expire_time :
notify_url :
success_url :
fail_url :
description :
custom_data1 :
custom_data2 :
{"flag":1,"msg":"success","action":"create-invoice","data":{"id":"5de7ab46b846fe6aa15931b2","invoice_id":"TCN122","merchant_id":"5bc46fb28ebb8363d2657347","url":"https://coinremitter.com/invoice/5de7ab46b846fe6aa15931b2","total_amount":{"TCN":"0.04713949","USD":"2.21979838","EUR":"2"},"paid_amount":[],"usd_amount":"2.21979838","conversion_rate":{"USD_TCN":"0.02123594","TCN_USD":"47.09"},"base_currency":"EUR","coin":"TCN","name":"random name","description":"Hello world","wallet_name":"my-wallet","address":"QbrhNkto3732i36NYmZUNwCo4gvTJK3992","status":"Pending","status_code":0,"notify_url":"http://yourdomain.com/notify-url","success_url":"http://yourdomain.com/success-url","fail_url":"http://yourdomain.com/fail-url","expire_on":"2018-12-06 10:35:57","invoice_date":"2019-12-04 18:19:10","custom_data1":"custom_data1","custom_data2":"custom_data2","last_updated_date":"2019-12-04 18:19:10"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/create-invoice
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form amount=' '
--form name=' '
--form currency=' '
--form expire_time=' '
--form notify_url=' '
--form success_url=' '
--form fail_url=' '
--form description=' '
--form custom_data1=' '
--form custom_data2=' '
Get Invoice
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
invoice_idRequired |
string
|
TCN002 |
Invoice ID which you want to get |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
It is data object
|
POST Get Invoice https://coinremitter.com/api/v3/TCN/get-invoice
Parameter
api_key :
password :
invoice_id :
{"flag":1,"msg":"success","action":"get-invoice","data":{"id":"5b7650458ebb8d306365624a2","invoice_id":"TCN002","merchant_id":"5bc46fb28ebb8d363d2657347","url":"https://coinremitter.com/invoice/5b7650458efbb8306365624a2","total_amount":{"TCN":"0.04713949","USD":"2.21979838","EUR":"2"},"paid_amount":{"TCN":"0.04713949","USD":"2.21979838","EUR":"2"},"usd_amount":"2.21979838","conversion_rate":{"USD_TCN":"0.02123594","TCN_USD":"47.09"},"base_currency":"EUR","coin":"TCN","name":"random name","description":"Hello world","wallet_name":"my-wallet","address":"rger54654fgsd4h6du7dgsg","payment_history":[{"txid":"3758c16f18fe868274bca152ca1g29fd7163bda59e8b514650c9825979","explorer_url":"http://coin-explorer-url/3758c16f18fe868274bca152cf...","amount":"0.04713949","date":"2021-02-27 15:05:02","confirmation":3}],"status":"Paid","status_code":1,"notify_url":"http://yourdomain.com/notify-url","success_url":"http://yourdomain.com/success-url","fail_url":"http://yourdomain.com/fail-url","expire_on":"2018-12-06 10:35:57","invoice_date":"2018-08-17 10:04:13","custom_data1":"custom_data1","custom_data2":"custom_data2","last_updated_date":"2018-08-17 10:04:13"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-invoice
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form invoice_id=' '
Get Fiat To Crypto Rate
Request Parameter
Parameter |
Type |
Sample Value |
---|
api_keyRequired |
string
|
$2y$10$oEj.DQbFaErQpUhce41IhO.dhBgnKBgtpCdQvo29wuEkcQV0yyW2eq |
Wallet API Key |
passwordRequired |
string
|
123456 |
Wallet Password |
fiat_symbolRequired |
string
|
USD |
Fiat Symbol |
fiat_amountRequired |
string
|
1 |
Fiat Amount |
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||||||||
It is data object
|
POST Get Fiat To Crypto Rate https://coinremitter.com/api/v3/TCN/get-fiat-to-crypto-rate
Parameter
api_key :
password :
fiat_symbol :
fiat_amount :
{"flag":1,"msg":"success","action":"get-fiat-to-crypto-rate","data":{"crypto_amount":"0.02123593","crypto_symbol":"TCN","crypto_currency":"Test Coin","fiat_amount":"1","fiat_symbol":"USD"}}
curl --request POST
--url https://coinremitter.com/api/v3/TCN/get-fiat-to-crypto-rate
--header 'content-type: multipart/form-data'
--form api_key=' '
--form password=' '
--form fiat_symbol=' '
--form fiat_amount=' '
Get Coin USD Price
GET Get Coin USD Price https://coinremitter.com/api/v3/get-coin-rate
Response
Response |
Type |
Sample Value |
---|
flag |
Integer
|
1 |
It indicates success or failure. 1 = success, 0 = fail. Read more |
msg |
String
|
success |
It explain reason of response. Do not compare this message in your code |
data |
Object
|
|
|||||||||
It is data object
|
Deposit/Withdraw Response
You will received webhook data on Deposit/Withdraw. What is Webhook ?
{"id":"5b7650458ebb8306365624a2","txid":"7a6ca109c7c651f9b70a7d4dc8fa77de322e420119c5d2470bce7f08ba0cd1d6","explorer_url":"http://coin-explorer-url/exp/7a6ca109c7c651f9b70a7d4dc8fa7...","merchant_id":"5bc46fb28ebb8363d2657347","type":"receive","coin_short_name":"TCN","wallet_id":"5c42ea0ab846fe751421cfb2","wallet_name":"my-wallet","address_label":"address-label","address":"MP78UQoDpkehY7mMy2Cn9HSfysz4wbCeN1","amount":"2","confirmations":3,"date":"2018-08-17 10:04:13"}
Notify Invoice Response
You will received Notification data on Invoice Payment
{"id":"5b7650458ebb8d306365624a2","invoice_id":"TCN002","merchant_id":"5bc46fb28ebb8d363d2657347","url":"https://coinremitter.com/invoice/5b7650458efbb8306365624a2","total_amount":{"TCN":"0.04713949","USD":"2.21979838","EUR":"2"},"paid_amount":{"TCN":"0.04713949","USD":"2.21979838","EUR":"2"},"usd_amount":"2.21979838","conversion_rate":{"USD_TCN":"0.02123594","TCN_USD":"47.09"},"base_currency":"EUR","coin":"TCN","name":"random name","description":"Hello world","wallet_name":"my-wallet","address":"rger54654fgsd4h6du7dgsg","payment_history":[{"txid":"3758c16f18fe868274bca152ca1g29fd7163bda59e8b514650c9825979","explorer_url":"http://coin-explorer-url/3758c16f18fe868274bca152cf...","amount":"0.04713949","date":"2021-02-27 15:05:02","confirmation":3}],"status":"Paid","status_code":1,"notify_url":"http://yourdomain.com/notify-url","success_url":"http://yourdomain.com/success-url","fail_url":"http://yourdomain.com/fail-url","expire_on":"2018-12-06 10:35:57","invoice_date":"2018-08-17 10:04:13","custom_data1":"custom_data1","custom_data2":"custom_data2","last_updated_date":"2018-08-17 10:04:13"}