API Documentation

Sending a gift

POST to https://secure.giftrocket.com/gifts with the following fields.

Field Description
api_key This can be found in your account settings after you've been granted API access (api@giftrocket.com).
payment_source Choose your payment option: 'card' or 'ach'. Your payment information must already be stored.
gift[amount] Amount of the gift in dollars. No cents. Max $1000.
gift[recipient_email] Recipient's email address.
gift[recipient_name] Recipient's name.
gift[sender_name] Sender's name.
gift[message_announce] Message to the recipient.
gift[yelp_business_id] Optional. You can specify a business for the gift by providing a yelp business id. This id can be found at the end of the URL for a business on Yelp. The yelp business ID for Pizzeria Delfina is pizzeria-delfina-san-francisco: http://www.yelp.com/biz/pizzeria-delfina-san-francisco.

Response

The response is returned in JSON format with the following fields. Please note that the API is in beta. If you receive a server error, please check your request fields and contact us if the problem continues.

Field Description
success Was the purchase successful?
error Error message if there was one.
confirmation_number Order confirmation number.
subtotal The amount specified for the gift.
service_fee Service fee.
total Total amount charged.