API v2

Power Global Gift Card Distribution with
EZ PIN APIs

Access 2,000+ digital products through one API, supported by 99.9% uptime. Complete transactions and deliver digital codes to users worldwide in under 60 seconds.

Get Sandbox Key Read the Docs

2,000+ Brands

120+ Countries

99.9% Uptime

POST /vendors/v2/orders/

curl -X POST https://api.ezpaypin.com/vendors/v2/orders/ \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": 1148,
    "quantity": 1,
    "price": 50.00,
    "pre_order": false,
    "reference_code": "5133fce1-7d02-4f37-9c01-73459d1735e2"
  }'

# Request — Create Gift Card Order

POST https://api.ezpaypin.com/vendors/v2/orders/

Authorization: Bearer {YOUR_ACCESS_TOKEN}

{

"sku": 1148, // iTunes US SKU

"quantity": 1,

"price": 50.00, // Face Value

"pre_order": false, // Instant Delivery

"reference_code": "5133fce1-7d02-4f37-9c01-73459d1735e2"

}

Developer Experience

Built for Developers. Ready for Scale.

Production-grade infrastructure designed for speed, security, and simplicity.

Sandbox First

Validate your integration in an isolated sandbox environment before going live, with full API parity and no setup cost.

Real-Time Webhooks

Receive instant order status updates, including accepted and rejected transactions, pushed directly to your endpoint. No polling required.

RESTful V2

Use standard HTTP methods with structured JSON responses. Swagger documentation and Postman collections are included.

Enterprise-Grade Security

OAuth 2.0 authentication and strict IP whitelisting help protect your integration and control access.

Live API Reference

Explore the API Live

View real request and response structures from our API documentation.

GET Catalog POST Order GET Balance

GET /vendors/v2/catalogs/

Browse 2,000+ Products

Retrieve the full gift card catalog, including real-time stock availability, face values, supported currencies, and country restrictions.

Filter by region, category, or currency.
View real-time delivery_type status.
Standard pagination support.

200 OK — JSON Response

{
  "count": 3,
  "results": [
    {
      "sku": 562,
      "title": "2,400 CALL OF DUTY: MODERN WARFARE POINTS",
      "min_price": 19.99,
      "max_price": 19.99,
      "pre_order": false,
      "currency": { "symbol": "$", "code": "USD" },
      "regions": [ { "name": "Global", "code": "GLC" } ]
    }
  ]
}

{

"count": 3,

"results": [

{

"sku": 562,

"title": "2,400 CALL OF DUTY: MODERN WARFARE POINTS",

"min_price": 19.99, "max_price": 19.99,

"pre_order": false,

"currency": { "symbol": "$", "code": "USD" },

"regions": [ { "name": "Global", "code": "GLC" } ]

}

]

}

POST /vendors/v2/orders/

Place Orders Instantly

Submit a gift card order and receive the redemption link or PIN instantly.

Idempotency supported via reference_code
Real-time stock check and validation
Share_link delivered in the response body

200 OK — Order Successful

{
  "order_id": 15513467,
  "status": 1,
  "status_text": "accept",
  "created_time": "2024-06-20T11:17:21",
  "reference_code": "5133fce1-7d02-4f37-9c01-73459d1735e2",
  "product": { "sku": 1148, "title": "App Store & iTunes US" },
  "delivery_type": 0,
  "destination": null,
  "terminal_id": 1912,
  "count": 1,
  "face_value": 50.0,
  "total_face_value": 50.0,
  "total_fees": 0,
  "total_discounts": -0.5,
  "total_customer_cost": 49.50,
  "is_completed": true,
  "exchange": { "currency": { "code": "USD" } },
  "share_link": "https://vc.ezpaypin.com/01c79b97-8ab4..."
}

{

"order_id": 15513467, "status": 1,

"status_text": "accept",

"reference_code": "5133fce1-7d02-4f37-9c01-73459d1735e2",

"product": { "sku": 1148, "title": "App Store & iTunes US" },

"delivery_type": 0, "destination": null,

"terminal_id": 1912, "count": 1,

"face_value": 50.0, "total_face_value": 50.0,

"total_fees": 0, "total_discounts": -0.5,

"total_customer_cost": 49.50,

"is_completed": true,

"exchange": { "currency": { "code": "USD" } },

"share_link": "https://vc.ezpaypin.com/01c79b97..."

}

GET /vendors/v2/balance/

Monitor Your Wallet

Programmatically retrieve live wallet balance across all currencies to trigger low-balance alerts.

Real-time balance data
Trigger automated top-ups
Prevent failed transactions

200 OK — JSON

[
  { "currency": { "currency": "Dollars", "symbol": "$", "code": "USD" }, "balance": 673.67 },
  { "currency": { "currency": "Dollars", "symbol": "CAD$", "code": "CAD" }, "balance": 49.50 },
  { "currency": { "currency": "Euro", "symbol": "€", "code": "EUR" }, "balance": 4.71 },
  { "currency": { "currency": "Pounds", "symbol": "£", "code": "GBP" }, "balance": 459.00 },
  { "currency": { "currency": "TestService", "symbol": "EZ", "code": "EZ" }, "balance": 9090.74 }
]

[

{ "currency": { "code": "USD" }, "balance": 673.67 },

{ "currency": { "code": "CAD" }, "balance": 49.50 },

{ "currency": { "code": "EUR" }, "balance": 4.71 },

{ "currency": { "code": "GBP" }, "balance": 459.00 },

{ "currency": { "code": "EZ" }, "balance": 9090.74 }

]

Integration Guide

Start Integrating in 3 Simple Steps

From your first API call to production-ready integration in under a day.

Request API Key

Create your account and receive your sandbox Client ID and Secret instantly.

Test in Sandbox

Use the full API in an isolated sandbox environment. Place test orders and validate your integration before going live.

Fund Wallet and Go Live

Add funds to your wallet by approved payment method, switch to the production endpoint, and start delivering live products.