Please use a desktop to view this page.

How to receive tibs

If you haven’t already, please check out our introduction to tibbing, and how it works for tib recipients.
No registration, password, or other details are required to receive tibs.
All you need is a bitcoin address. Getting one is easy. See our Bitcoin page.
If your tibs are paid to a supported charity (or other 3rd party) you don’t even need a bitcoin address.
We pay out received tibs once five or more have accumulated, or after seven days regardless.
Tibit earns GBP 2p (approx USD/EUR 3¢) per tib, when the tib is spent. There are no other fees.

Cut and paste

In our examples, you will see this bitcoin address:

mytibs9YhLYtrVhQkmTdbDS51H54WyrxTx

You must replace this with your own, public, bitcoin address. Similarly, other text in the sample code, like sub-reference codes and URLs, should also be replaced with your own values, if you require them.

Placeholder example text will look similar to:

article-1234 or https://your-domain.site/tib-button.png


Bitcoin

We use bitcoin to pay out your tibs to you.

Using bitcoin means that we can support customers from all around the world, that we don’t have to pass on international transfer and currency exchange fees, and that we can pay out in very small amounts, rather than holding on to and accumulating a sizeable amount before forwarding it to you.

It also means that we can ensure your income from tibs gets to you, without requiring you to register your details with us beforehand.

We convert users tibs to bitcoin just before we send you the payment, so the amount you receive isn’t subject to any significant impact from exchange rate movements.

If you’d like to find out more about collecting tibs please visit our site on a tablet, laptop or desktop computer!

Bitcoin address for tibs to be sent to
Style of tib button
Choose a colour for your button
Button size
This is a preview of your button - it works, give it a try!

Copy and paste this code into your webpage in the position you wish your button to appear, that's it, that's all you need to do!

Copy to clipboard

Bitcoin

Your bitcoin address

You’ll need a bitcoin address where we can deposit the tibs you receive, but you don’t need to know anything about bitcoin to get started. Use any of the services on the right to generate your unique bitcoin address in seconds.

Ensure that you keep your private key and/or pass-phrase secret, and don’t lose it!

Bit Address Keybase warp wallet Brain Wallet

Your bitcoin address

You’ll need a bitcoin address where we can deposit the tibs you receive, but you don’t need to know anything about bitcoin to get started. Use any of the services on the right to generate your unique bitcoin address in seconds.

Ensure that you keep your private key and/or pass-phrase secret, and don’t lose it!

Crypto Pay Bit Pay Circle

Using your bitcoin address

Once you’ve accumulated some tibs at your bitcoin address, you will probably want to exchange them for local currency, or spend them. There are many online and downloadable bitcoin wallets available, and you can choose whichever you like.

On the left are some online bitcoin service providers that can get you up and running in minutes.


Your bitcoin address

Once you’ve accumulated some tibs at your bitcoin address, you will probably want to exchange them for local currency, or spend them. There are many online and downloadable bitcoin wallets available, and you can choose whichever you like.

On the left are some online bitcoin service providers that can get you up and running in minutes.

Circle


Why bitcoin?

You can think of bitcoin as you would any foreign currency, the bitcoin network as something like email for money, and your bitcoin address a little like a bank account

We use bitcoin to send you your money so that tibbing can be global, without needing to interface with each country’s unique banking systems. Simply include your bitcoin address in your link to tibit. As we pay out your received tibs, they are deposited directly into the address that you specified. There is no need to register with tibit.


Why bitcoin?

You can think of bitcoin as you would any foreign currency, the bitcoin network as something like email for money, and your bitcoin address a little like a bank account

We use bitcoin to send you your money so that tibbing can be global, without needing to interface with each country’s unique banking systems. Simply include your bitcoin address in your link to tibit. As we pay out your received tibs, they are deposited directly into the address that you specified. There is no need to register with tibit.

Confirmation snippets

When provided with a webpage URL in the TIB parameter, social snippet information will be retrieved and shown to the user on the tib confirmation screen. A title, description, and image will be retrieved when possible.

This information is cached on Tibit’s servers, so a change to the page may not immediately be visible to users.

Example

Open Graph

The Open Graph Protocol is the best way to add or specify social snippet details on the webpage. In most cases, this will ensure the same information is shown when your page is shared on social media platforms.

To specify the information to be displayed, add HTML <meta> tags in the <head> section of your pages:

<meta property="og:image" content="http://your-domain.site/images/some-image.jpg" />

<meta property="og:title" content="Title for this Page or Article."/>

<meta property="og:description" content="Your description of this page or article…" />

Content

It is best if the image you specify is square, and still works well when cropped top and bottom. For Tibit, it only needs to be 200x200px, but for general use across social and other sites 1200x1200px is ideal.

The description will be truncated to four lines, around 400 characters, when displayed on Tibit. But keep in mind that, for tibbing, the user has probably just come from the page described. It’s more important that the description is written for other social media, where it is informing people who are yet to visit the content when they read the description.

Check your snippet info

To see which image, title, and description will be displayed to users when they tib your site, enter the URL provided in the TIB parameter into this Meta Inspector demo site.

JavaScript buttons

You can get a dynamic tib button by including a snippet of JavaScript in your site code. A tib button implemented this way looks more inviting than a link, and can display a counter and respond when the user spends a tib.

Simplest

For a default tib button, the code below can simply be copy and pasted into your site. Don’t forget to replace the bitcoin address with your own public bitcoin address.

<script src='https://cdnjs.cloudflare.com/ajax/libs/script.js/2.5.8/script.min.js'></script>

<script>

    $script('https://widget.tibdit.com/assets/js/tib.js', function() {

        tibInit( {

            PAD: 'mytibs9YhLYtrVhQkmTdbDS51H54WyrxTx'

        });

    });

</script>

<button class='bd-tib-btn'></button>

Changing the appearance

You can control the style and appearance of the button. The shape, colour, and height in pixels can all be specified using the BTN, BTC, and BTH parameters.

<script src='https://cdnjs.cloudflare.com/ajax/libs/script.js/2.5.8/script.min.js'></script>

<script>

    $script('https://widget.tibdit.com/assets/js/tib.js', function() {

        tibInit( {

            PAD: 'mytibs9YhLYtrVhQkmTdbDS51H54WyrxTx',

                BTN: 'horiz',

                BTC: '#FF00FF',

                BTH: '42'

        });

    });

</script>

<button class='bd-tib-btn'></button>

You can also set these parameters for individual buttons, by setting data-bd- attributes like this:

<button class='bd-tib-btn' bd-btn-BTN='horiz' bd-btn-BTC='#FF00FF' data-bd-btn-BTH='42'></button> 

You can see the available button style names, or use our button factory to generate the code for you to copy and paste.

Multiple items

If you have more than one item that can be tibbed, add a sub-reference to each button, so that users can tib each item separately. The sub-reference can be any anything that identifies the specific item. Buttons that are for the same item should have the same sub-reference.

<button class='bd-tib-btn' data-bd-SUB='article-123'></button> 

Snippet

By default, the URL of the page holding the button will be used to display the snippet your users see on the tib-confirmation screen. We retrieve a title, description, and thumbnail image from this URL where possible. See the snippets page for more details. You can specify a different URL to use by specifying the TIB parameter. e.g.

<button class='bd-tib-btn' data-bd-TIB='your-domain.site/page-to-use'></button> 

After user confirmation

The tibit popup window will be redirected to your domain with a proof-of-tib token when the user clicks the confirm tib button. This will be detected by the button JavaScript, which will extract the counter from the token and close the popup window, after making a record of the tib in browser storage.

Advanced custom callback handling is available by specifying a destination URL using the CBK parameter. For more about this see the callbacks page.

Sending tibs to a 3rd party

You can also specify an assignee, such as a supported charity, instead of a bitcoin address. See the assignees page for more about how to configure your button, and see our button factory – charity edition, to get the settings for your chosen charity.

Multiple buttons on one page

If you have multiple tib buttons on a single page, you can improve page loading time by splitting up the code snippet.

Put the <script> tags once at the top of each page:

<script src='https://cdnjs.cloudflare.com/ajax/libs/script.js/2.5.8/script.min.js'></script>

<script>

    $script('https://widget.tibdit.com/assets/js/tib.js', function() {

        tibInit( {

            'PAD' : 'mytibs9YhLYtrVhQkmTdbDS51H54WyrxTx'

        });

    });

</script>

And place buttons where you wish using <button> tags.

<button class='bd-tib-btn' bd-btn-SUB="article-123"></button>

Callbacks

Advanced topic

When a CBK parameter is provided, rather than simply closing the Tibit popup window when the user confirms a tib, it is redirected to the provided callback address with a proof-of-tib token, and a cryptographic signature, in the URL querystring.

This callback and token can be used to simply redirect the user to a thankyou page, or to implement a sophisticated response such as unlocking content.

tib.js

The callback handler included in tib.js can be used for automatic generation and browser-based handling of callbacks. By default, if the CBK parameter is not specified, tib.js will set CBK to be the site home page (the current page’s protocol and hostname). After opening the Tibit popup window, tib.js polls that window to watch for a proof-of-tib token being returned when the window is redirected to the current site. It then extracts and processes the token before closing the popup window.

Alternatively, a specific tib confirmation callback page can be specified in the CBK parameter. This page should either include tib.js to handle the callback directly, or alternatively implement custom code to process the proof-of-tib token, either in the browser, or the site back-end.

Tib.js records users tibs in a browser ‘cookie’ (actually in localStorage) until they expire, typically in 24 hours. Expired localStorage entries for a site are removed by tib.js whenever it loads on that site.

Decoding

The URL the user’s browser is forwarded to after tib confirmation will be similar to this

https://your-domain.site/?tibtok=eyJRVFkiOjI1LCJQQUQiOiIxQXJjaGl2ZTFuMkM1NzlkTXNBdTNpQzZ0V3p1UUp6OGROIiwiU1VCIjoidHJ5LWludGVybmV0LWFyY2hpdmUiLCJJU1MiOiIyMDE2LTEwLTMxVDE3OjU0OjM1LjMzOSswMDowMCIsIklOSSI6IlhJYndORTdTU1UiLCJTUkMiOiJjb25maXJtX3RpYiJ9&tibsig=7upTos4xCapS4LTsNsTYHpFQnr0RxtrYPlnRWz8PAQarHuTcYKNznnvzumRR3by3wwdSaeZdB03GSksjPQTjDA%3D%3D

The querystring parameter tibtok contains the proof-of-tib token. It is a urlencoded and base64 encoded JSON object. The tibsig parameter contains a cryptographic signature that can be used to verify the token’s authenticity.

tibtok=eyJRVFkiOjI1LCJQQUQiOiIxQXJjaGl2ZTFuMkM1NzlkTXNBdTNpQzZ0V3p1UUp6OGROIiwiU1VCIjoidHJ5LWludGVybmV0LWFyY2hpdmUiLCJJU1MiOiIyMDE2LTEwLTMxVDE3OjU0OjM1LjMzOSswMDowMCIsIklOSSI6IlhJYndORTdTU1UiLCJTUkMiOiJjb25maXJtX3RpYiJ9

After decoding to JSON, the token payload is available.

{"QTY":25,"PAD":"mytibs9YhLYtrVhQkmTdbDS51H54WyrxTx","SUB":"article-123","ISS":"2016-10-31T17:54:35.339+00:00","INI":"XIbwNE7SSU","SRC":"confirm_tib"}

Token payload

The proof-of-tib token fields include

  • QTY: The total quantity of tibs spent on this combination of tibbed article URL (TIB) or bitcoin payment address (PAD), and sub-reference (SUB);
  • PAD: the actual bitcoin address the tib payment will be forwarded to.
  • SUB: Any sub-reference provided
  • ISS: The time the token was issued
  • INI: a truncated SHA-1 hash of the data sent to initiate the tib (experimental)
  • SRC: The source of the proof-of-tib token, typically a user tib confirmation (experimental)

Custom parameters

Any unrecognised parameters included in the initial request to https://tib.me will be reflected back in the callback URL. This can be used to record anything like a user or session ID, or a nonce value, from your site, that may be useful when processing the proof-of-tib token.

Common origin

If the callback page is required to share information with other pages, such as with the page on your site containing the tib button, it is important that both pages share the same origin. This means that the protocol part of the URL (i.e. http:// or https://) and the hostname part (e.g. www.your-domain.site or your-domain.site) must be identical. If one is http, and the other https, or one includes www and the other doesn’t, then the browser pages will not be able to share information.

Unless you are sure that requests to your domain will always be redirected to a consistent protocol (i.e. https://) and a consistent hostname (i.e. always with, or always without the www prefix) then you should specify the full, exact callback URL including the protocol part, matching the protocol and hostname from the browser window containing the tib button.

Verification

Generally, payments made through Tibit are of low enough value that you may not want to verify the proof-of-tib token at all. Simply checking for the existence of the tibtok parameter may be sufficient. This is especially true for tibs spent as tips and donations, rather than payments.

However, it is possible to forge a token, so we provide ways you can guarantee that it is genuine and came from Tibit, including a cryptographic Ed25519/NaCL signature. See the verification page for more on this.

Token verification

Nonces

You can include a nonce in the querystring in the initial request to https://tib.me, then check it when reflected back in the proof-of-tib token.

Any additional querystring parameters you supply are incorporated into the callback URL and reflected back to the callback address.

Cryptographic signature

Along with the token in the tibtok parameter, the tibsig parameter provides a cryptographic signature which can be verified against our published private key.

This is implemented using the modern and extremely safe, yet relatively lightweight NaCl implementation of the Ed52219 protocols.

Request hash

The INI parameter in the token is a SHA-1 hash of the data received by https://tib.me to initatiate the tib.

This can be used to check that the data received by https://tib.me was unchanged from the parameters you specified.

Issue time

To add a small amount of extra work to prevent simply replaying an older, previously spent tib and resulting token, you can simply check the token issue time is recent.

This is enough to add a level of complexity, requiring that a new token be generated, which may be sufficient for your use case, given the value of each individual tib.

WordPress

  • WordPress plugin can be installed from WordPress.org for free
  • No coding required
  • Allows you to choose from a selection of designs
  • Updated regularly with the latest features
Get the wordpress plugin

Collecting tibs on a WordPress site is easy – just watch our
explainer video to learn how!