API 샌드박스

const timestamp = Date.now().toString();
const appId     = 'YOUR_APP_ID';
const body      = JSON.stringify({
  requestId: 'REQ-20260304-0001',
  storeId: '123',
  serviceName: 'MyShop',
  itemName: 'ITEM-GAME-001',
  itemPrice: 12.34,
  orderCurrencyCode: 'USD',
  returnUrl: 'https://myshop.com/payment/returnUrl',
  callbackUrl: 'https://myshop.com/payment/callbackUrl',
  expiresAt: '2026-08-31T00:00:00Z'
});

const hmac = generateHmac(
  'YOUR_APP_SECRET',
  'POST' + '/api/seller/v1/payment/link' + appId + timestamp + body
);

const res = await fetch(
  'https://unifi.me/pay/api/seller/v1/payment/link',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': apiKey,
      'X-Timestamp': timestamp,
      'X-Authorization-Hmac': hmac
    },
    body
  }
);
const data = await res.json();

import requests, hmac, hashlib, base64, time, json

app_id     = "YOUR_APP_ID"
app_secret = "YOUR_APP_SECRET"
timestamp  = str(int(time.time() * 1000))
uri        = "/api/seller/v1/payment/link"
body       = json.dumps({
    "requestId": "REQ-20260304-0001",
    "storeId": "123",
    "serviceName": "MyShop",
    "itemName": "ITEM-GAME-001",
    "itemPrice": 12.34,
    "orderCurrencyCode": "USD",
    "returnUrl": "https://myshop.com/payment/returnUrl",
    "callbackUrl": "https://myshop.com/payment/callbackUrl",
    "expiresAt": "2026-08-31T00:00:00Z"
}, separators=(',', ':'))

msg = "POST" + uri + app_id + timestamp + body
sig = base64.b64encode(
    hmac.new(
        app_secret.encode(),
        msg.encode(),
        hashlib.sha256
    ).digest()
).decode()

res = requests.post(
    "https://unifi.me/pay" + uri,
    headers={
        "Content-Type": "application/json",
        "X-API-Key": api_key,
        "X-Timestamp": timestamp,
        "X-Authorization-Hmac": sig
    },
    data=body
)
print(res.json())

"code": "BAD_REQUEST",
"message": "requestId is required"

"code": "UNAUTHORIZED",
"message": "Invalid HMAC signature"

const txnId    = 'txn_abc123';
const timestamp = Date.now().toString();
const appId     = 'YOUR_APP_ID';
const uri       = `/api/seller/v1/payment/${txnId}`;

// GET 요청은 body 없음
const hmac = generateHmac(
  'YOUR_APP_SECRET',
  'GET' + uri + appId + timestamp
);

const res = await fetch(
  `https://unifi.me/pay${uri}`,
  {
    headers: {
      'X-API-Key': apiKey,
      'X-Timestamp': timestamp,
      'X-Authorization-Hmac': hmac
    }
  }
);
const data = await res.json();

import requests, hmac, hashlib, base64, time

txn_id     = "txn_abc123"
app_id     = "YOUR_APP_ID"
app_secret = "YOUR_APP_SECRET"
timestamp  = str(int(time.time() * 1000))
uri        = f"/api/seller/v1/payment/{txn_id}"

# GET 요청은 REQUEST_BODY가 빈 문자열
msg = "GET" + uri + app_id + timestamp + ""
sig = base64.b64encode(
    hmac.new(
        app_secret.encode(),
        msg.encode(),
        hashlib.sha256
    ).digest()
).decode()

res = requests.get(
    f"https://unifi.me/pay{uri}",
    headers={
        "X-API-Key": api_key,
        "X-Timestamp": timestamp,
        "X-Authorization-Hmac": sig
    }
)
print(res.json())

"code": "PAYMENT_TRANSACTION_NOT_FOUND",
"message": "Transaction not found"

const from      = '2026-03-01T00:00:00Z';
const to        = '2026-03-31T23:59:59Z';
const timestamp = Date.now().toString();
const appId     = 'YOUR_APP_ID';
const uri       = `/api/seller/v1/payment/settlement/transaction?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}&page=0&size=20`;

const hmac = generateHmac(
  'YOUR_APP_SECRET',
  'GET' + uri + appId + timestamp
);

const res = await fetch(
  `https://unifi.me/pay${uri}`,
  {
    headers: {
      'X-API-Key': apiKey,
      'X-Timestamp': timestamp,
      'X-Authorization-Hmac': hmac
    }
  }
);
const data = await res.json();

import requests, hmac, hashlib, base64, time
from urllib.parse import urlencode

from_date  = "2026-03-01T00:00:00Z"
to_date    = "2026-03-31T23:59:59Z"
app_id     = "YOUR_APP_ID"
app_secret = "YOUR_APP_SECRET"
timestamp  = str(int(time.time() * 1000))
params     = urlencode({"from": from_date, "to": to_date, "page": 0, "size": 20})
uri        = f"/api/seller/v1/payment/settlement/transaction?{params}"

msg = "GET" + uri + app_id + timestamp
sig = base64.b64encode(
    hmac.new(
        app_secret.encode(),
        msg.encode(),
        hashlib.sha256
    ).digest()
).decode()

res = requests.get(
    f"https://unifi.me/pay{uri}",
    headers={
        "X-API-Key": api_key,
        "X-Timestamp": timestamp,
        "X-Authorization-Hmac": sig
    }
)
print(res.json())

"code": "PAYMENT_INVALID_REQUEST",
"message": "Date range must not exceed 90 days"