Introducing Blockbolt’s Unified Payment Interface, First on Sui

BlockBolt
BlockBolt
Published in
3 min readJun 28, 2024

Blockbolt has implemented the Unified Payment Interface to seamlessly interact with the Sui Blockchain, allowing for the receipt of payments on a global scale. This can be achieved by simply sending a parameter in the URL for the payment.

The platform is designed to accommodate a wide range of cryptocurrencies, including the native coin $sui on the Sui blockchain, stable coins, and tokens from projects within the Sui Ecosystem.

These capabilities make it a versatile and comprehensive solution for processing payments across different currencies and assets.

Let’s explore the intricacies of how this system functions.

To initiate a payment using the Blockbolt payment protocol, merchants just need to include the payment information in the URL.

You can create a Blockbolt Unified Payment URL — https://unifiedlink.blockbolt.io/

Please find a detailed explanation of URL parameters.

1. Merchant (Receiver) Sui Wallet Address

  • Parameter: merchant_address
  • Please enter your Sui wallet address where you want to receive payment.
  • This field supports SNS! You can use the Sui domain name instead of the Sui wallet address.
  • This field is compulsory.

2. Merchant (Receiver) Name

  • Parameter: merchant_name
  • Please enter your business name.
  • This field is compulsory.

3. Amount

  • Parameter: amount
  • Please enter the requested amount.
  • This field supports numeric values only.
  • This field is compulsory.

4. Order ID.

  • Parameter: order_id
  • Please enter the order ID to record the transaction.
  • This field supports numeric values only.
  • This field is compulsory.

Example URL.

https://pay.blockbolt.io/blockbolt:payment?merchant_address=0xe18153764efe31f5a50bcf1ee2e599c82f7b627d506fb915020d5fa4478baa74&merchant_name=BlockBolt&order_id=312754&amount=1

Certainly! The above URL will initiate a request to receive payment in Sui coin on the mainnet.

For more specific actions, you can utilize the parameters below to modify the network to Testnet, as well as the coin and token options.

5. Blockchain

  • Parameter: blockchain
  • This field is optional, by default it passes the ‘Sui’ blockchain as a blockchain value if it is not mentioned on the URL.

6. Network

  • Parameter: network
  • Please enter the network — Mainnet or Testnet.
  • This field is optional, by default it passes ‘Mainnet’ as a network if it is not mentioned on the URL.

7. Coin

  • Parameter: coin_name
  • Please enter the coin name in which you want to accept the payment.
  • This field is optional, by default it passes ‘Sui’ as a coin if it is not mentioned on the URL.
  • You will have options for Sui Ecosystem token if payment is requested on Mainnet Network.

8. Coin Type.

  • Parameter: coin_type
  • Please enter the coin type.
  • This field is optional, by default it passes the ‘Sui’ coin type as a coin type if it is not mentioned on the URL.

Example URL:

https://pay.blockbolt.io/blockbolt:payment?merchant_address=0xe18153764efe31f5a50bcf1ee2e599c82f7b627d506fb915020d5fa4478baa74&merchant_name=Blockbolt&order_id=116708&amount=1&network=Mainnet&blockchain=sui&coin_name=FUD&coin_type=0x76cb819b01abed502bee8a702b4c2d547532c12f25001c9dea795a5e631c26f1::fud::FUD

Advanced Options:

Customer (Sender) Address

If you wish to exclusively receive payments from a particular SUI wallet address, you have the option to specify it in the URL.

  • Parameter: customer_address
  • Please enter your customer sui wallet address.
  • This field supports SNS! You can use the Sui domain name instead of the Sui wallet address.

Note: Your customer must have to pay from the mentioned Sui Wallet address only, otherwise the transaction will not initiate.

Example URL.

https://pay.blockbolt.io/blockbolt:payment?merchant_address=0xe18153764efe31f5a50bcf1ee2e599c82f7b627d506fb915020d5fa4478baa74&customer_address=0x8e4c64ee47cd0ddc43be74caaa505d6a5064a411ebd6f6531e933f29890604f9&merchant_name=Blockbolt&order_id=736657&amount=1&network=Mainnet&blockchain=sui&coin_name=SUI&coin_type=0x2::sui::SUI

Call Back URL (3rd Party Integration)

Integrating a Unified Payment Interface (UPI) into your application or website allows you to seamlessly receive payments.

Similar to third-party integration, all you need to do is specify the callback URL within the Blockbolt Payment URL to enable this functionality.

  • Parameter: back_url
  • Please enter the complete URL where you want to redirect the customer after successful payment.
  • You will get the ‘Order ID’ and ‘Transaction ID’ in return.

For testing purposes, you can use the below URL as ‘call back’ URL.

https://unifiedlink.blockbolt.io/success

Example URL.

https://pay.blockbolt.io/blockbolt:payment?merchant_address=0xe18153764efe31f5a50bcf1ee2e599c82f7b627d506fb915020d5fa4478baa74&merchant_name=Blockbolt&order_id=903731&amount=1&network=Testnet&blockchain=sui&coin_name=SUI&coin_type=0x2::sui::SUI&back_url=https://unifiedlink.blockbolt.io/success

To make a payment, what do your customers need?

The payer has two options as follows.

1st Option: Sui Web Browser Extension

Customer is required to connect their wallet and complete the payment process.

2nd Option: Blockbolt Mobile Application

Customers can use the BlockBolt mobile app to scan and pay without connecting a wallet.

If you are interested in integrating this technology into your application or website to facilitate payments on the SUI blockchain, please contact us using the contact information provided below.

We are enthusiastic about collaborating and eager to explore this opportunity with you.

Thank you!

--

--

BlockBolt
BlockBolt

Peer to Peer Payment Gateway on Sui, Venom & Aptos