post https://partners-staging.safegold.com/v1/users//actions/gift-gold-verify
This endpoint will let you create a gifting transaction. User ID of the Sender needs to be passed in the URL. On successful verification, the gold amount will be deducted from the senders wallet.
Once the Verify API is successful, the Sender’s wallet balance will be deducted. For adding the gold to the Receiver once the receiver accepts the gift, Distributor will call the Gifting Confirm API.
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.
| Method Type | POST |
|---|---|
| Staging URL | https://partners-staging.safegold.com/v1/users/{user_id}/actions/gift-gold-verify |
| Production URL | https://partners.safegold.com/v1/users/{user_id}/actions/gift-gold-verify |
| 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. |
| receiver_id | The receiver’s user_id. |
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. |
| rate_id | The rate_id which was passed by Safegold in the response of Live Sell Price API. |
| sender_id | User ID of the Sender. |
| receiver_id | User ID of the Receiver. |
| 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 | Code Description |
|---|---|---|
| HTTP Status 400 | ||
| 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 | |
| 6 | Receiver Not Registered | |
| 7 | Receiver ID Cannot Be Same As Sender ID |