Sandbox — Môi trường thử nghiệm

# API Sandbox - Tạo payout thử nghiệm
curl -X POST https://sandbox.api.pay27.vn/v1/payouts \
  -H "X-API-Key: pb_test_x1y2z3a4b5c6d7e8f9" \
  -H "Content-Type: application/json" \
  -d '{
    "gateway": "paypal",
    "amount": 50.00,
    "currency": "USD",
    "recipient": "test@example.com",
    "note": "Test payout from sandbox"
  }'

# Response (dữ liệu ảo)
{
  "id": "txn_sandbox_a1b2c3d4",
  "status": "completed",
  "gateway": "paypal",
  "amount": 50.00,
  "currency": "USD",
  "created_at": "2026-06-02T07:30:00Z",
  "sandbox": true
}

// Cài đặt: npm install @pay27/sdk

import { Pay27 } from "@pay27/sdk";

const client = new Pay27({
  apiKey: "pb_test_x1y2z3a4b5c6d7e8f9",
  environment: "sandbox",   // Quan trọng: dùng "sandbox"
});

const payout = await client.payouts.create({
  gateway: "paypal",
  amount: 50.0,
  currency: "USD",
  recipient: "test@example.com",
  note: "Test payout from sandbox",
});

console.log(payout.id);      // txn_sandbox_a1b2c3d4
console.log(payout.status);  // completed
console.log(payout.sandbox); // true

# Cài đặt: pip install pay27-sdk

from pay27 import Pay27Client

client = Pay27Client(
    api_key="pb_test_x1y2z3a4b5c6d7e8f9",
    environment="sandbox"    # Quan trọng: dùng "sandbox"
)

payout = client.payouts.create(
    gateway="paypal",
    amount=50.00,
    currency="USD",
    recipient="test@example.com",
    note="Test payout from sandbox"
)

print(payout.id)       # txn_sandbox_a1b2c3d4
print(payout.status)   # completed
print(payout.sandbox)  # True

// Cài đặt: composer require pay27/sdk

use Pay27\Client;

$client = new Client([
    'api_key' => 'pb_test_x1y2z3a4b5c6d7e8f9',
    'environment' => 'sandbox',  // Quan trọng: dùng "sandbox"
]);

$payout = $client->payouts->create([
    'gateway' => 'paypal',
    'amount' => 50.00,
    'currency' => 'USD',
    'recipient' => 'test@example.com',
    'note' => 'Test payout from sandbox',
]);

echo $payout['id'];      // txn_sandbox_a1b2c3d4
echo $payout['status'];  // completed

// Cach mo phong webhook tu Dashboard

// 1. Vao Dashboard > Webhooks > "Mô phỏng"
// 2. Chon loai event muon test, vi du: payout.completed

// Payload webhook được gửi đến endpoint của bạn:

{
  "event": "payout.completed",
  "data": {
    "id": "txn_sandbox_a1b2c3d4",
    "status": "completed",
    "gateway": "paypal",
    "amount": 50.00,
    "currency": "USD",
    "recipient": "test@example.com",
    "created_at": "2026-06-02T07:30:00Z",
    "sandbox": true
  },
  "sandbox": true
}

// Header: X-Pay27-Signature (HMAC-SHA256)
// Dùng sandbox webhook secret de verify