Limitless VIP API

Receive Payment API
The easiest way to receive payments in Limitless VIP! You don't even need to install the wallet on your server.

HOW DOES IT WORK? IF YOU'RE ALREADY RECEIVING BITCOIN PAYMENTS WITH BLOCKCHAIN'S API, YOU ALREADY KNOW HOW TO ADD TITTIECOIN SUPPORT.

Through a GET call, you ask for a unique TittieCoin address. Every payment sent there will be automatically forwarded to you, and your server gets an instant notification.

Secure payments

Masternodes secure the netowrk while accepting payments on your website.

Scalable

Covers any website and needs no other software, fast secure transactions are standard.

Here's how the process worksAPI Process

  • The user makes an order
  • Your server asks for a new address
  • api.tittiecoin.com returns a new address
  • Your server displays the address to the user
  • The user makes the payment to api.tittiecoin.com
  • api.tittiecoin.com forwards the payment and instantly notifies your server
  • Your server delivers the order to the user
API Process

First, you need a TittieCoin address to receive forwarded payments
You don't need to install the wallet on your server, but you do need and address to receive the payments.

OptionsThere are several

Desktop Wallet

Cold storage

An exchange


Use TittieCoin's APIto get a unique TittieCoin address for your user

Call this method to create a unique address and present it to the user. You should create a new address for every order, or at least every user. However, you could use your same address to receive the forwarded payment.

  • The minimum supported amount is 2 TIT (after fee charges).
  • The current cost of the service is: 0% plus a fixed fee of 2 TIT
  • Check the variables fee_percent and fee_fixed (see below) after every call to get updated information.

https://api.tittiecoin.com/receive.php?method=create&address;=$receiving_address&callback;=$callback_url
(Important: Your Callback URL may be called immediately to validate it. It should not process anything if the parameters value or input_address are missing).

Response:
200 OK, APPLICATION/JSON
{
"fee_percent":0,
"fee_fixed":2,
"destination":"$receiving_address",
"input_address":"TZDQb8LNaJq1gBxxiKXYFbDNHpRM9QFAx6",
"callback_url":"$callback_url",
"salt_hash":"iBkhwPi1HTa7TBgdHkeycg9KZgf5rPf9"
}

salt_hash is used to create a unique security hash on every call to your callback URL (see below).
Note your callback URL cannot exceed 255 characters.

If your callback URL is not valid, or if there is any other error, you'll get this:

Response:
ERROR 500, TEXT/PLAIN
This is the error description


Implementing the CallbackWhen a payment is received

When a payment is received, api.tittiecoin.com will notify your server. It will do so by calling the callback url you sent.

The following parameters will be supplied via GET:

  1. {Custom} All the parameters you included in your callback URL, for example purchase_id
  2. value The value of the payment received in Tittoshis. Divide by 100000000 to get the value in TittieCoins.
  3. input_address The TittieCoin address that received the payment from your user.
  4. confirmations The number of confirmations of that transaction.
  5. transaction_hash The hash of the forwarding transaction, or empty if the payment hasn't been forwarded yet.
  6. input_transaction_hash The hash of the original transaction, before the forwarding.
  7. destination_address The address where the payment was or will be forwarded to. Check this matches your own address.
  8. security_hash A lower case md5 hash calculated as md5( salt_hash + "-" + input_transaction_hash + "-" + value + "-" + confirmations ).

Note: Your payment will be forwarded to destination_address (and therefore transaction_hash will be supplied) when the original transaction (input_transaction_hash) reaches 1 confirmations (confirmations).

Expected response: *ok*

Once your server has successfully processed the information sent by api.tittiecoin.com, it must respond with the text "*ok*".
If it responds with anything else, the callback will be resent again every 3 minutes for up to 500 times (25 hours).

Once your server has responded with *ok*, it won't receive a callback for the same transaction.


Security

Store salt_hash on your database when you call /receive.php. Then, when you receive the callback, calculate it and compare with the receive parameter security_hash (see example above).
This method is recommended because the salt_hash will be encrypted by SSL (because the API uses http).

Additionally (or instead), you can pass your own security code when calling /receive.php. That same value will be passed to your callback, so you can compare it.

Also, to prevent chargebacks or double spends, make sure to verify the number of confirmations (see example above).


Address Expiration and Limits

Every generated address is guaranteed to work for one month.

There is no limit on how many times you can use this API. However, your server can be banned under some conditions:

  • A great percentage of requested addresses never receive payments (usually, more than 500 and more than 90%).
  • Your server never responds with *ok* or usually takes several hours to do so.
  • Your server is constantly unreachable.


Testing your Callback: /test

You can use this tool to test your Callback URL and the complete process:

/test

When your Callback is reached by this tool, you'll receive and additional parameter test=true.
You should not process anything when that parameter is received (see example above).


Open-source PHP example

You can download a simple but complete PHP/MySQL example on Github.

https://github.com/tittiecoin/tittiecoin-api

Which is installed and running here:
https://api.tittiecoin.com/receive_payment_php_demo/