AGCOD

Amazon Gift Code On Demand (AGCOD) API v2 implementation for distribute Amazon gift cards (gift codes) instantly in any denomination.

Installation

Add this line to your application's Gemfile:

gem'aws_agcod'

And then execute:

$ bundle

Or install it yourself as:

$ gem install aws_agcod

Usage

Configure

require"aws_agcod"AGCOD.configuredo |config|
config.access_key="YOUR ACCESS KEY"config.secret_key="YOUR SECRET KEY"config.partner_id="PARTNER ID"# The `production` config is important as it determines which endpoint# you're hitting.config.production=true# This defaults to false.# Optionally, you can customize the URI completely.config.uri="https://my-custom-agcod-endpoint.com"config.region="us-east-1"# defaultconfig.timeout=30# defaultend

Create Gift Code/Card

request_id="test"amount=10currency="USD"# default to USD, available types are: USD, EUR, JPY, CNY, CADrequest=AGCOD::CreateGiftCard.new(request_id,amount,currency)# When succeedifrequest.success?request.claim_code# => code for the gift cardrequest.gc_id# => gift card idrequest.request_id# => your request idelse# When failedrequest.error_message# => Error response from AGCOD serviceend

Cancel Gift Code/Card

request_id="test"gc_id="test_gc_id"request=AGCOD::CancelGiftCard.new(request_id,gc_id)# When failedunlessrequest.success?request.error_message# => Error response from AGCOD serviceend

Get Gift Code/Card activities

request_id="test"start_time=Time.now - 86400end_time=Time.nowpage=1per_page=100show_no_ops=false# Whether or not to show activities with no operationrequest=AGCOD::GiftCardActivityList.new(request_id,start_time,end_time,page,per_page,show_no_ops)ifrequest.success?request.results.eachdo |activity|
activity.status# => SUCCESS, FAILURE, RESENDactivity.created_atactivity.typeactivity.card_numberactivity.amountactivity.error_codeactivity.gc_idactivity.partner_idactivity.request_idendelserequest.error_message# => Error response from AGCOD serviceend

Contributing

1. Fork it ( https://github.com/[my-github-username]/aws_agcod/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request