IFrame / web interface

iFrame and web integrations in Tuti Gateway¶

Start the process by creating a new account via: Via our online onboarding portal
Contact Tuti Gateway team for account creations mailto:adonese@Tuti Gateway.dev
The team will go with you through simple integration steps, to comply with KYC
- in the future it will be about sending us a selfie of you + ID cards

Required fields and API endpoints¶

PAYMENT_URL: https://https://pay.2t.sd

Our payment checkout is hosted at: https://https://pay.2t.sd. The URL for payment will be like this:

https://https://pay.2t.sd/?biller=biller_id?id=merchant_defined_id&token=noebs_payment_uuid_token&to=redirect_url_after_payment&hooks=hooks_endpoint_for_post_payment

Fields:

field	definition
id	merchant specific id, for example cart ID
token	Tuti Gateway specific token, UUID
url	url to be redirect the user to, after the payment is completed
hooks	hooks endpoint, to send the response message to the system

Important

token: is requested from Tuti Gateway beforehand, by calling: PAYMENT_URL/payment_token/:biller_id

payment token¶

Endpoint: https://beta.app.2t.sd/api/v1/payment_token/:biller_id

The request only have biller_id as a named url query. biller_id is Tuti Gateway specific biller's name. The response would be like this:

{"result":{"id":"dabceba4-2d23-41d9-9832-f4f005353ce0","uuid":"dabceba4-2d23-41d9-9832-f4f005353ce0"}

Note

id and uuid are the same. We recommend you to use uuid instead, just for the explicitness.

id will be used later as token

How the payment scenario works¶

User enters to Sara website
User add items to cart
User proceed to checkout
Sara's website performs generate payment_token api
Sara's website parse the corresponding uuid from payment_token
uuid will be used by Sara as token
Sara can generate the payment token on events like windows.load, or make a dedicated button for that.
Sara website then will have the sufficient information to complete the payment:
- payment token
- amount
- id (if she has an id for their cart, or 0 for default value)
- hooks (if she want to use Tuti Gateway webhooks to update her cart system)

Get billers transactions¶

Endpoint: HOST_URL/v1/merchant/i?biller=:biller_id

Note

biller_id: is the assigned Tuti Gateway biller for the particular merchant

Reach out for any help or support. We will publish more examples soon!

Sign up as a merchant and start accepting funds