Gyft Developer Docs

Expected Response Status

200 OK

Request URL

https://apitest.gyft.com/mashery/v1/reseller/account

Sample Response

{
    "id": "29849-2323-2312-31",
    "status": 0,
    "application_name": "My Test App",
    "usd_exchange_rate": "1.0",
    "balance": "200.00",
    "balance_updated_when": "89899091"
}

Request URL

https://apitest.gyft.com/mashery/v1/reseller/merchants

Sample Response

{
    "id": "22",
    "name": "Test Merchant", 
    "card_name": "Test Merchant Gift Card",
    "description": "A short description about Test Merchant.",
    "long_description": "<p>A long description about Test Merchant. The 
            very best merchant for all shopping. This description is returned 
            in HTML format.</p>",
    "country_code": "US",
    "homepage_label": "Go to Test Merchant website",
    "homepage_url": "https://testmerchantwebsite.com",
    "min_card_value": 25,
    "max_card_value": 50,
    "icon_url": "http://....png"
    "cover_image_url_hd": "http://....png",
    "legal_disclaimer_html":"Merchant terms and conditions"
}

Request URL

https://apitest.gyft.com/mashery/v1/reseller/shop_cards

Sample Response

{
    "id": "220",
    "merchant_id": "22",
    "merchant_name": "Test Merchant", 
    "long_description": "<p>A long description about Test Merchant. The 
            very best merchant for all shopping. This description is returned 
            in HTML format.</p>",
    "card_currency_code": "USD", 
    "opening_balance": 10,
    "merchant_card_template_id": 22, 
    "cover_image_url_hd": "http://....png", 
    "merchant_icon_image_url_hd": "http://....png"
}

Request URL

https://apitest.gyft.com/mashery/v1/reseller/categories

Sample Response

{
    "id": "3",
    "name": "Department Stores", 
}

Request URL

https://apitest.gyft.com/mashery/v1/reseller/transactions

Sample Response

{
    "id": 22000,
    "type": 1,
    "amount": -10.00,
    "transaction_reference": "29849-2323-2312-31",
    "notes": "Test purchase using the Gyft API!",
    "created_when": 1428356249000
 }

Request URL

https://apitest.gyft.com/mashery/v1/reseller/transactions/last/2

Sample Response

{
    "id": 22011,
    "type": 1,
    "amount": -10.00,
    "created_when": 1428356249001
 },{
    "id": 22010,
    "type": 1,
    "amount": -5.00,
    "created_when": 1428356249000
 }

Request URL

https://apitest.gyft.com/mashery/v1/reseller/transactions/first/2

Sample Response

{
    "id": 22000,
    "type": 0,
    "amount": 100.00,
    "created_when": 1428356249000
 },{
    "id": 22001,
    "type": 1,
    "amount": -5.00,
    "created_when": 1428356249001
 }

Request URL

https://apitest.gyft.com/mashery/v1/reseller/transaction/22010

Sample Response

{
    "id": 22010,
    "transaction_notes": "Test purchase using the Gyft API!",
    "merchant_name": "Test Merchant",
    "amount": -5.00,
    "delivered_to": "testrecipient@gyft.com",
    "auto_delivered": "Y",
    "revealed": "N",
    "gift_status": 0,
    "card_status": 5,
    "opening_balance": 5.00,
    "current_balance": 5.00,
    "transaction_created": 1428356249000,
    "user_created": 1428929607000
}

Request URL

https://apitest.gyft.com/mashery/v1/reseller/transaction/refund/22010

Sample Response

{
    "id": "xDGJxz0987zr4357b2453",
    "status": 0,
    "gf_reseller_transaction_id": 22010,
    "email": testrecipient@gyft.com
}

Request URL

https://apitest.gyft.com/mashery/v1/partner/purchase/gift_card_direct

Sample Response

{
    "id": 23010,
    "url": "https://staging.gyft.com/..."
}

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.security.MessageDigest;

public class MasheryTestMain {
  public static void main(String... args) throws Exception {
    String apiKey = args[0];
    String apiSecret = args[1];
    String timestamp = Long.toString(
      Math.round(System.currentTimeMillis() / 1000.0)
    );
    String stringToSign = apiKey + apiSecret + timestamp;
    MessageDigest digest = MessageDigest.getInstance("SHA-256");
    byte[] hash = digest.digest(stringToSign.getBytes("UTF-8"));
    String signature = hexEncode(hash);
    String fullURLString = String.format(
      "https://apitest.gyft.com/mashery/v1/reseller/account?api_key=%s&sig=%s",
      apiKey,
      signature
    );
    URL url = new URL(fullURLString);
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();
    conn.setRequestProperty("x-sig-timestamp", timestamp);
    BufferedReader br = new BufferedReader(
      new InputStreamReader((conn.getInputStream()))
    );
    String output;
    while ((output = br.readLine()) != null) {
      System.out.println(output);
    }
    conn.disconnect();
  }
  private static String hexEncode(final byte[] bytes) {
    StringBuilder hexEncode = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
      String hex = Integer.toHexString(0xFF & bytes[i]);
      if (hex.length() == 1) hexEncode.append('0');
      hexEncode.append(hex);
    }
    return hexEncode.toString();
  }
}

<?php
$apiKey = $argv[1];
$apiSecret = $argv[2];
$timestamp = time();
$stringToSign = $apiKey . $apiSecret . $timestamp;
$hash = hash('sha256', $stringToSign, true);
$signature = bin2hex($hash);
$fullURLString = sprintf(
  'https://apitest.gyft.com/mashery/v1/reseller/account?api_key=%s&sig=%s',
$apiKey,
$signature
);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $fullURLString);
curl_setopt($curl, CURLOPT_HTTPHEADER, array('x-sig-timestamp: '.$timestamp));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
echo curl_exec($curl)."\n";
?>

import sys, httplib, hashlib, time

apiKey = sys.argv[1]
apiSecret = sys.argv[2]
timestamp = str(long(round(time.time())))
stringToSign = apiKey + apiSecret + timestamp
signature =  hashlib.sha256(stringToSign).hexdigest()
host = "apitest.gyft.com"
path = "/mashery/v1/reseller/account?api_key=%s&sig=%s" % (apiKey, signature)
conn = httplib.HTTPSConnection(host)
conn.putrequest("GET", path)
conn.putheader("x-sig-timestamp", timestamp)
conn.endheaders()
response = conn.getresponse()
data = response.read()
print data
conn.close()

require 'digest'
require 'net/http'

apiKey = ARGV[0]
apiSecret = ARGV[1]
timestamp = Time.now.getutc.to_i.to_s
stringToSign = apiKey + apiSecret + timestamp
sha256 = Digest::SHA256.new
signature = sha256.hexdigest(stringToSign)
fullURLString = "https://apitest.gyft.com/mashery/v1/reseller/account?api_key=%s&sig=%s" % [apiKey, signature]
uri = URI(fullURLString)
req = Net::HTTP::Get.new(uri)
req['x-sig-timestamp'] = timestamp
res = Net::HTTP.start(uri.hostname, uri.port) {|http|
  http.request(req)
}
puts res.body

var apiKey = process.argv[2];
var apiSecret = process.argv[3];
var timeStamp = Math.round(new Date().getTime() / 1000).toString();
var stringToSign = apiKey + apiSecret + timeStamp;
var sha256 = require('crypto').createHash('sha256');
var signature = sha256.update(stringToSign).digest('hex');
var http = require('http');
http.get(
  {
    hostname: 'apitest.gyft.com', 
    port: 443, 
    method: 'GET',
    path: '/mashery/v1/reseller/account?api_key=' + apiKey + '&sig=' + signature, 
    headers: {'x-sig-timestamp': timeStamp}
  },
  function(res) {
    res.on('data',
      function(chunk) {
        console.log(chunk.toString());
      }
    )
  }
);

using System;
using System.IO;
using System.Net;
using System.Text;
using System.Security.Cryptography;

namespace MasheryTestMain
{
  class MainClass
  {
    public static void Main(string[] args)
    {
      string apiKey = args[0];
      string apiSecret = args[1];
      TimeSpan timeStan = DateTime.UtcNow - new DateTime(1970, 1, 1);
      string timestamp = ((int)timeStan.TotalSeconds).ToString();
      string stringToSign = apiKey + apiSecret + timestamp;
      SHA256 sha256 = SHA256Managed.Create();
      byte[] messageBytes = Encoding.UTF8.GetBytes(stringToSign);
      byte[] hash = sha256.ComputeHash(messageBytes);
      string signature = HexEncode(hash);
      string fullURLString = String.Format(
        "https://apitest.gyft.com/mashery/v1/reseller/account?api_key={0}&sig={1}",
        apiKey,
        signature
      );
      HttpWebRequest req = WebRequest.Create(fullURLString) as HttpWebRequest;
      req.Headers.Add("x-sig-timestamp", timestamp);
      string output = null;
      using (HttpWebResponse res = req.GetResponse() as HttpWebResponse)
      {
        StreamReader reader = new StreamReader(res.GetResponseStream());
        output = reader.ReadToEnd();
      }
      Console.WriteLine(output);
    }
    private static string HexEncode(byte[] bytes)
    {
      StringBuilder hexEncode = new StringBuilder();
      for (int i = 0; i < bytes.Length; i++)
        hexEncode.Append(bytes[i].ToString("X2"));
      return hexEncode.ToString().ToLower();
    }
  }
}