This endpoint will let you create a gifting transaction. User ID of the Sender needs to be passed in the URL.
This Verify API will be called by the Distributor if the receiver is not registered with SafeGold. Distributor can also handle the scenario if the Receiver is not registered with the Distributor itself.
Once the Verify API is successful, the Sender’s wallet balance will be deducted. Once the Gifting Verify API (with receiver ref id) has been called, the status of the particular transaction would be (Status - 3) as the gold amount for the particular transaction would be deducted from the customer’s balance.
For the receiver, SafeGold will create a Dummy ID and send it as a response on the success of the Gifting Verify API. Once the customer has accepted the gift or has been onboarded by the Distributor, Distributor will call a registration API of SafeGold to register the User with SafeGold by providing the Transaction ID that was sent in the response of the Gifting Verify API.
Once the customer has been registered, for adding the gold to the Receiver once the receiver accepts the gift, Distributor will call the Gifting Confirm API.
Request Parameters
| Field | Description |
|---|---|
| rate_id | The rate_id which was passed by SafeGold in the response of Live Sell Price API. |
| gold_amount | Gold Amount corresponding to the Sell Price |
| sell_price | The final Amount which the Sender wishes to send to the Receiver. |
Success 200 Response parameters
| Field | Description |
|---|---|
| tx_id | Unique Transaction ID provided by Safegold which will be passed to the next endpoint to confirm the transaction. |
| sender_id | User ID of the Sender |
| receiver_id | Dummy receiver id created by SafeGold. |
| rate_id | The rate_id which was passed by Safegold in the response of Live Sell Price API |
| gold_amount | Gold Amount corresponding to the Sell Price. |
| sell_price | The final Amount which the Sender wishes to send to the Receiver. |
Failure Parameters
| Status Code | Code | Description |
|---|---|---|
| HTTP Status 500 | ||
| 1 | Missing required information | |
| 2 | Sender Not registered | |
| 3 | Insufficient Balance | |
| 4 | SG Rate does not match the current rate | |
| 5 | Gold Amount does not match |
Post the success of the Gifting Verify API, Gift Confirm API will be called by the Distributor by passing the Sender’s User ID in the URL and by sending transaction ID as a request.