Hosted Checkout with Tazapay

This is the easiest integration to enable over 70+ localised payment options for your buyers around the world via Tazapay's checkout

To complete a checkout with Tazapay, you'll need to:

  1. Ensure users exist or are created before initiating a transaction. The users in the transaction have to be mapped as a buyer and a seller.
  2. A transaction is created between the participating users, along with the cart value and currency.
  3. The buyer is redirected to make their payment for the transaction.

Create/Get User

You can initiate a Create User API call for buyers and sellers if they don't exist in Tazapay's database. To check if the user exists, you can make a Get User by ID or Get User by Email API call.


This API call needs the entity type as individual or business in ind_bus_type, email, country, and name (first_name and last_name for individuals, business_name for businesses) for the purposes of user creation.

Upon creating the user, their account_id acts as the UUID of the user.

To optimize load time, you can call the Create User API anytime during checkout or when users sign up on your online platform for the first time.

Create Transaction

Once you have the buyer's and seller's UUID, you can initiate a Create Escrow API call.


This API call needs the invoice_amount, invoice_currency, buyer_id & seller_id in the form of their UUID, initiated_by to indicate which party initiated the transaction, and a description of the transaction in txn_description.

Types of Currencies

Invoice Currency: The currency in which the transaction is listed or invoiced.

Collection Currency: The currency used by the buyer to pay for the transaction. If this is different from the invoice currency, we apply our FX rates to show the invoice currency amount in the collection currency equivalent value.

Settlement Currency: The currency used to settle to the seller. This is currently limited to the seller’s local currency or USD. Again, we apply our FX rates to convert to the settlement currency if it is different from the invoice currency.

Buyer Checkout

Once the buyer clicks 'Place Order and Pay', you can initiate a Create Payment API call. This returns a URL which you can use to redirect the buyer to the co-branded payment page.

To find out how this will help with eCommerce platform payments, check out our website URL.

Did this page help you?