Docs 0xProcessing
  • 💡Basic
    • General
      • Terms and definitions
      • Available assets
      • Transaction Fees
    • Introduction guide
      • Deposit flow
      • Payment form
      • Withdrawal flow
      • VRCS - automatic conversion to stablecoins
      • Webhooks flow
      • Web3 processing
      • 0xProcessing use cases
  • 🔑0xProcessing API
    • Obtaining API Keys
    • Deposits
      • Payment form with fixed amount
      • Payment without fixed amount
      • Static wallet
    • Withdrawals
      • Withdrawal by client
      • Check withdrawal status by Withdrawal ID
    • Webhooks
      • Payment form with fixed amount
      • Payment without fixed amount
      • Static wallet
      • Withdrawals
    • Informational Commands
      • Request for balances
      • Coin info
    • Crypto or Fiat Equivalent
      • Fiat currency conversion
      • Conversion of fiat currencies into cryptocurrency
      • Conversion of cryptocurrencies into fiat currencies
      • List of supported fiat currencies for conversion
    • Errors
  • âš¡Web3 processing API
    • Introduction
    • Web3 pool API
  • 🚀Quick start
    • Account registration
    • API set up
    • Setting up Webhooks
    • Payment confirmation
    • Managing withdrawals
    • Create a Manager role
    • Currency management
    • VRCS setup
    • Balance management
    • Transactions and address tracking
    • Notifications
    • Account security
    • Match Crypto Wallet Addresses
  • 🔄FAQ
Powered by GitBook
On this page
  • What is crypto payment form?
  • Payment form with a fixed amount
  • Payment form without a fixed amount
  • Static wallet
  • Payment form generated by the link
  1. Basic
  2. Introduction guide

Payment form

Guide to setting up and customizing payment forms to create efficient, user-friendly, and reliable crypto transaction solutions for your customers.

PreviousDeposit flowNextWithdrawal flow

Last updated 8 months ago

What is crypto payment form?

Payment form for crypto payments differs from classic payment methods. Users can send their funds using exchanges and crypto wallet applications instead of classic payment forms.

Crypto payment form is a block with the information about payment conditions and crypto address where funds should be sent.

The main idea is to provide a user with a deposit crypto address and all necessary information about deposit limits, exchange rates and other payment conditions.

Also it will be a good idea to provide crypto addresses using QR codes that users can use as an automatic way to open their wallet application and send a cryptocurrency in one click.

In this section you will learn how to provide the user with all the necessary information, how to implement QR codes to your payment form and what best practices exist in order to make the payment form user friendly, to increase its conversion rate and to avoid user mistakes.

Payment form with a fixed amount

Payment form with fixed amount - form generated on the 0xProcessing side, with a fixed payment amount, unique wallet address for payment and buttons to connect Web3 wallets.

In this form we get such data as the type of cryptocurrency, the amount that must be sent for the deposit to be successful, the address to which you need to send money, QR code, which is a wallet address, which can be scanned for example in the application exchange from which you will send money.

Also, there are buttons to connect Web3 wallets and convenient payment from them. To do this, the user must have funds either on Metamask, or on another web3 wallet and connect it through "Wallet connect".

To manage the form after receiving the payment status, the following parameters are used:

CancelURL - the address to which the Cancel button will be redirected from the payment form. The address must support SSL

SucsessURL - the address to which the Back to website button will be redirected from the payment form. The address must support SSL

AutoReturn - true if the user needs to be automatically redirected from the form to SuccessUrl after confirming the transactions in the blockchain

Payment form without a fixed amount

Payment without a fixed amount is a type of payment in which the merchant can create his custom payment form based on the received payment data with a unique address for each payment. The client can pay any amount at his discretion, but not less than the minimum amount, the payment will be automatically accounted by the system upon confirmation in the blockchain.

To display the QR code as an image, please add the QR code data to the "img" tag with the "src" attribute.

Static wallet

When requesting a top-up on the merchant platform side, sends a request to 0xProcessing to generate the client's wallet, the merchant receives the client's wallet from 0xProcessing and can convert it into a QR code using any popular services. All this data can be embedded in the client's account on the merchant's platform

How to create QR code for static wallet?

In order to create the QR code you can use Google Chart Service and encode the URI.

You can use this link directly inside the <img> tag:

<img src="https://chart.googleapis.com/chart?chs=150x150&cht=qr&chl=bitcoin:3AFaCnqriLNxj15kqtp5Pxn8puHfuqbX7W&choe=UTF-8">

When the user scans this QR code they will be able to open the wallet application and to make the deposit in one click.

Payment form generated by the link

In the link you need to put your merchant account ID (required), currency of payment, amount, SuccessUrl and CancelUrl to redirect client after payment:

https://app.0xprocessing.com/payment/create/?MerchantId=_____&Currency=_____&Amount=_____&AmountUsd=____&BillingID=_____&ClientID=_____&SuccessUrl=_____&CancelUrl=_____&AutoReturn=_____

if the payment details are not specified in the link, the client can enter them independently in a special form

To create simple QR codes including the link to the wallet address the following parameters should be used:

chs - QR code size ("150x150" size is used as an example) cht - chart type ("qr" is necessary for QR code) chl - the data encoded in the QR code ("bitcoin:3AFaCnqriLNxj15kqtp5Pxn8puHfuqbX7W" has been used in the example above, but additional parameters can be used according to "BIP-0021" standard documentation: ) choe - encoding type of the QR code data ("UTF-8" is required by "BIP-0021" standard)

💡
More about parameters
More about payment data
https://chart.googleapis.com/chart?chs=150x150&cht=qr&chl=bitcoin:3AFaCnqriLNxj15kqtp5Pxn8puHfuqbX7W&choe=UTF-8
https://github.com/bitcoin/bips/blob/master/bip-0021.mediawiki
Example Payment form without a fixed amount integration on merchant side
Example static wallet integration on merchant side
QR example