How to use UnknownXfam Gateway

1. Before you start

UnknownXfam Gateway collects UPI payments straight into your own UPI ID and checks automatically when a payment arrives. You need three things:

• A Gmail address (only @gmail.com addresses can sign up).
• Your UPI ID, for example yourname@bank. The money goes directly to it.
• The Gmail that receives your payment alert emails. You connect it once, read-only, so the gateway can see a payment arrived.

Order of setup: create account, wait for approval, save UPI ID, add API key, connect Gmail. After that you are ready to take payments.

2. Create your account

1. Open Get Started (top right) or the Create a free account link on the login page.
2. Type your Name.
3. Type your Gmail address, like you@gmail.com.
4. Choose a Password of at least 8 characters, then type it again in Confirm password.
5. Press Request account.

Each email address and each UPI ID can be used on one account only. If you see "That email is already registered", go to Log in instead.

3. Verify your email and wait for approval

1. If the site asks you to verify your email, open your inbox and find the 6-digit code. Check Spam or Promotions if you cannot see it.
2. Type the code on the Verify your email page and press Verify. Press Resend code if it does not arrive.
3. Your dashboard then shows Waiting for admin approval, unless your account is approved automatically. Nothing else is needed from you.
4. When you are approved, the dashboard opens fully. Come back to this guide at step 5.

If approval takes long, message support: @UnknownNvrDie.

4. Log in

With your password

1. Open Log in.
2. Type your Email address and Password (press Show to see what you typed).
3. Press Log in. You land on your Dashboard.

With an email code (no password needed)

1. On the login page press Email me a login code.
2. Type your email and press Send code.
3. Type the 6-digit code from your inbox and press Log in.

To log out, press Logout at the top right, or at the bottom of Profile.

5. Add your UPI ID

This is the UPI ID that receives every payment. You can do this only after your account is approved.

1. Log in and press Profile at the top (this opens Settings).
2. In the Profile box, find UPI ID.
3. Type your UPI ID in the form yourname@bank. Use small letters and no spaces.
4. Press Save. You will see Settings saved.

Check the spelling twice. Every QR code pays this exact UPI ID. If it says "That UPI ID is already linked to another account", that ID is in use by someone else, so contact support.

6. Add your API key

The API key is what lets your website, app or bot create and check payments. An admin issues it to you, you cannot make it yourself.

1. After you have saved your UPI ID, message support (@UnknownNvrDie) and ask for your API key.
2. Open Profile, then scroll to the API Key box.
3. Paste the key into API Key. Press Show to check it, and Copy to copy it later.
4. Press Save. You will see API key saved.

Keep the key private. Anyone who has it can create and check your payments. Never post it in a public chat or a public website file. You can see when it expires on your Dashboard, in the Key expiry card. When it expires, ask support for a new one.

If you were given a shared key

1. On Profile scroll to Shared API key.
2. Paste it into Admin-issued shared key and press Add shared key.
3. To remove it later, press Remove shared key.

7. Connect Gmail

This is required. The gateway reads the payment alert emails in this Gmail to confirm a payment arrived. It is read-only: it never sends, deletes or changes your email, and it never sees your Google password.

1. Open your Dashboard.
2. Find the Gmail box and press Connect Gmail.
3. On the Google page choose the Gmail that receives your payment alerts, and allow the read-only access.
4. You return to the dashboard and see Connected with your Gmail address.

Handy buttons

• Check payment emails checks your inbox right now for new payments.
• Open Gmail tab (or the Gmail inbox tab at the top) shows your latest 6 emails.
• Disconnect Gmail removes access. Payments will stop being confirmed until you connect again.
• If it says Reconnect needed, press Reconnect Gmail and sign in to Google again.

Your FamPay balance on the dashboard fills in by itself from your FamApp "Updated Balance" email once Gmail is connected.

8. Your API URLs

When your UPI ID and API key are saved, Profile shows ready-made URLs with your details already filled in. You only replace the words in curly brackets, like {amount}.

• Generate QR / Create Payment makes a new payment for an amount and gives you a QR and a UPI link.
• Check Payment By UTR / TXN ID checks one payment by its UTR or order ID.
• Universal UTR Verification checks a UTR or transaction ID and does not need your UPI ID.
• Payment Status Check shows the status of an order by its order ID. It is read-only.

To try one before using it

1. Open Profile and find the URL box you want.
2. Type an amount (for example 499), a UTR or an order ID in the small box under the URL.
3. Press Test. The answer appears below. Press Copy next to the URL to use it in your project.

If the URLs are missing, one of these is not done yet: UPI ID saved, API key saved, or the key has expired.

9. Take a payment

1. Create the payment. Open your Generate QR / Create Payment URL with an amount from 1 to 100000 (up to 2 decimals). The answer contains the order_id, the upi_link and the qr_url (the QR image).
2. Show the QR or the UPI link to your customer.
3. The customer pays with any UPI app (GPay, PhonePe, Paytm, BHIM and so on) and must pay the exact amount.
4. The gateway confirms it. It matches the payment alert email in your Gmail with the order. The status changes to PAID.
5. Check it with Payment Status Check using the order ID, or look at Payments on your Dashboard.

What the statuses mean

• PENDING: waiting for the customer to pay.
• PROCESSING: a matching payment was found and is being double-checked.
• PAID: payment confirmed.
• EXPIRED: the QR was not paid in time (each QR lasts 15 minutes). Create a new one.
• UNSUCCESSFUL: the payment did not go through.
• NOT_FOUND: no order with that ID.

Before you hand over goods or services, it is always good to look at your own bank or UPI app too.

10. Read your dashboard

• Received: total money from paid orders. Successful: how many were paid.
• FamPay balance: read from your latest FamApp email.
• Key expiry: the date and time your API key (and shared key) stop working.
• Payments table: Order ID, Payment ID, Amount, Status, UTR, Txn ID, Verified by and Created time. Use the Show menu to pick All payments, Successful, Pending or Expired.
• The page refreshes by itself, so new payments appear without reloading.
• The light / dark switch at the top changes the look of the site.

11. Change or reset your password

If you forgot it (not logged in)

1. On the login page press Forgot password?
2. Type your email and press Send code.
3. Type the 6-digit code, then your New password and Confirm new password.
4. Press Update password, then log in with the new password.

If you are logged in

1. Open Profile, then the Password tab.
2. Ask for the email code, type it, choose a new password and save.

12. Problems and answers

I did not get the 6-digit code. Check Spam and Promotions, wait a minute, then press Resend code.

It says "Only Gmail login is allowed". Use your @gmail.com address.

I cannot see the UPI ID box. Your account is not approved yet. Wait for approval (step 3).

"That key was not issued for your account". The key does not belong to you. Copy it again exactly as support sent it, with no spaces.

My API key expired. Ask support for a new key and save it in Profile.

My payment stays PENDING. Check that Gmail shows Connected, that the customer paid the exact amount to the right UPI ID, and press Check payment emails.

The QR says it is no longer valid. It lasted 15 minutes. Create a new payment.

Gmail says "Reconnect needed". Press Reconnect Gmail and sign in again.

My account is frozen or the API is disabled. An admin has turned it off. Contact support.

Still stuck? Message us on Telegram: @UnknownNvrDie. Please also read the Terms and the Privacy Policy.