Gift Cancel API

As the Sender’s gold wallet balance gets deducted during the Gifting Verify API, if the Receiver fails to accept the gift within a particular time or Receiver rejects the gift, Distributor will call the Gifting Cancel API to reverse the gold amount back to the Sender.

Method Type	POST
Staging URL	https://partners-staging.safegold.com/v1/users/{id}/gift-gold-cancel
Production URL	https://partners.safegold.com/v1/users/{id}/gift-gold-cancel

Request Parameters

Field	Description
tx_id	This would be the Transaction ID which was passed by Safegold in the previous Gifting Verify API for the particular User ID.

Success 200 Response Parameters

Field	Description

Failure Parameters

Status Code	Code	Code Description
HTTP Status 400
	1	Missing required information
	2	Invalid Transaction ID
	3	User ID/ Vendor ID Mismatch
	5	User ID missing in transaction

📘
Points to Remember

Make sure to pass the tx_id received as response from Gift Verify with/without receiver ID API to the Gift Cancel API in the body parameter.