GrineoPay API Documentation

# Example: Fetch your active wallet-backed payment options
curl -X GET "https://app.grineopay.com/api/grineopay/v1/merchant/wallets/active" \
  -H "X-Api-Key: gp_live_your_api_key_here" \
  -H "X-Api-Secret: gp_secret_your_api_secret_here"

https://app.grineopay.com/api/grineopay/v1

https://app.grineopay.com/api/grineopay/v1/health

# 1) Check API health
curl -X GET "https://app.grineopay.com/api/grineopay/v1/health"

# 2) Check active wallet-backed assets
curl -X GET "https://app.grineopay.com/api/grineopay/v1/merchant/wallets/active" \
  -H "X-Api-Key: gp_live_your_api_key" \
  -H "X-Api-Secret: gp_secret_your_api_secret"

# 3) Create a payment session
curl -X POST "https://app.grineopay.com/api/grineopay/v1/payments/create" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: gp_live_your_api_key" \
  -H "X-Api-Secret: gp_secret_your_api_secret" \
  -d '{
    "amount": 49.99,
    "currency": "USD",
    "crypto_currency": "BTC",
    "order_id": "ORD-2024-00123",
    "email": "[email protected]",
    "return_url": "https://shop.com/thank-you",
    "source": "api",
    "domain": "shop.com",
    "order_context": "checkout"
  }'

{
  "event": "crypto_payment.updated",
  "transaction_id": 1042,
  "order_id": "ORD-2024-00123",
  "status": "completed",
  "fiat_amount": 49.99,
  "fiat_currency": "USD",
  "crypto_amount": 0.00081234,
  "crypto_currency": "BTC",
  "crypto_network": "BTC",
  "deposit_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "tx_hash_in": "a1b2c3d4e5f6...",
  "tx_hash_out": "f6e5d4c3b2a1...",
  "provider_id": "a1b2c3d4e5f6g7h8",
  "timestamp": "2024-07-15 14:45:22"
}

# Replace the JSON body and signature with values generated using your webhook secret
curl -X POST "https://yourdomain.com/webhooks/grineopay" \
  -H "Content-Type: application/json" \
  -H "X-GrineoPay-Signature: your_generated_hmac_signature_here" \
  -d '{
    "event": "crypto_payment.updated",
    "transaction_id": 1042,
    "order_id": "ORD-2024-00123",
    "status": "completed",
    "fiat_amount": 49.99,
    "fiat_currency": "USD",
    "crypto_amount": 0.00081234,
    "crypto_currency": "BTC",
    "crypto_network": "BTC",
    "deposit_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "tx_hash_in": "a1b2c3d4e5f6...",
    "tx_hash_out": "f6e5d4c3b2a1...",
    "provider_id": "a1b2c3d4e5f6g7h8",
    "timestamp": "2024-07-15 14:45:22"
  }'

# Recommended retry strategy
attempt 1: wait 0 seconds
attempt 2: wait 2 seconds
attempt 3: wait 4 seconds
attempt 4: wait 8 seconds
attempt 5: wait 16 seconds
# Stop after a sensible retry limit and log the failure

<?php
class GrineoPay_Client {
    private $api_key;
    private $api_secret;
    private $base_url;

    public function __construct($api_key, $api_secret, $base_url) {
        $this->api_key = $api_key;
        $this->api_secret = $api_secret;
        $this->base_url = rtrim($base_url, '/');
    }

    public function createPayment(array $params) {
        $ch = curl_init($this->base_url . '/payments/create');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json',
            'X-Api-Key: ' . $this->api_key,
            'X-Api-Secret: ' . $this->api_secret,
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);

        $response = curl_exec($ch);
        $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        return [
            'status' => $http_code,
            'data' => json_decode($response, true),
        ];
    }

    public function verifyMerchantWebhookSignature($raw_body, $signature, $webhook_secret) {
        $expected = hash_hmac('sha256', $raw_body, $webhook_secret);
        return hash_equals($expected, $signature);
    }
}

$client = new GrineoPay_Client(
    'gp_live_your_api_key',
    'gp_secret_your_api_secret',
    'https://app.grineopay.com/api/grineopay/v1'
);

$result = $client->createPayment([
    'amount' => 99.50,
    'currency' => 'USD',
    'crypto_currency' => 'USDT',
    'crypto_network' => 'TRX',
    'order_id' => 'SHOP-' . uniqid(),
    'email' => '[email protected]',
    'return_url' => 'https://shop.com/success',
    'source' => 'woocommerce',
    'domain' => 'shop.com',
    'order_context' => 'woocommerce',
]);

if ($result['status'] === 200 && !empty($result['data']['success'])) {
    // Store the transaction_id in your system
    header('Location: ' . $result['data']['payment_url']);
    exit;
}

// Merchant webhook handler example:
$raw_body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_GRINEOPAY_SIGNATURE'] ?? '';
$webhook_secret = 'whsec_your_signing_secret';

if (!$client->verifyMerchantWebhookSignature($raw_body, $signature, $webhook_secret)) {
    http_response_code(401);
    exit('Invalid signature');
}

$payload = json_decode($raw_body, true);

switch ($payload['status']) {
    case 'completed':
        // fulfilOrder($payload['order_id'], $payload['transaction_id']);
        break;
    case 'failed':
        // failOrder($payload['order_id']);
        break;
    case 'refunded':
        // markRefunded($payload['order_id']);
        break;
}

http_response_code(200);
echo 'OK';

<button id="gp-checkout-btn" onclick="initiateCryptoPayment()">
  Pay with Crypto
</button>

<script>
async function initiateCryptoPayment() {
  const btn = document.getElementById('gp-checkout-btn');
  btn.disabled = true;
  btn.textContent = 'Processing...';

  try {
    // Call YOUR backend, not GrineoPay directly from the browser
    const response = await fetch('/api/create-crypto-payment', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        orderId: 'ORD-' + Date.now(),
        amount: 49.99,
        currency: 'USD',
        crypto: 'BTC',
        customerEmail: '[email protected]'
      })
    });

    const data = await response.json();

    if (data.success) {
      window.location.href = data.payment_url;
    } else {
      alert('Payment initialization failed: ' + data.message);
    }
  } catch (error) {
    alert('Network error. Please try again.');
  } finally {
    btn.disabled = false;
    btn.textContent = 'Pay with Crypto';
  }
}
</script>