API & Schema Mapping

POST https://business.coinbase.com/api/v1/payment-links
Authorization: Bearer YOUR_JWT_TOKEN
X-Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324

{
  "amount": "100.00",
  "currency": "USDC",
  "network": "base",
  "description": "Payment for order #12345",
  "expiresAt": "2024-12-31T23:59:59Z",
  "successRedirectUrl": "https://example.com/success",
  "failRedirectUrl": "https://example.com/failed",
  "metadata": {
    "order_id": "12345",
    "customer_id": "cust_abc123"
  }
}

GET https://business.coinbase.com/api/v1/payment-links?pageSize=20&status=ACTIVE
Authorization: Bearer YOUR_JWT_TOKEN

GET https://business.coinbase.com/api/v1/payment-links/{paymentLinkId}
Authorization: Bearer YOUR_JWT_TOKEN

POST https://business.coinbase.com/api/v1/payment-links/{paymentLinkId}/deactivate
Authorization: Bearer YOUR_JWT_TOKEN

cdpcurl -X POST \
  -i "YOUR_API_KEY_ID" \
  -s "YOUR_API_KEY_SECRET" \
  "https://api.cdp.coinbase.com/platform/v2/data/webhooks/subscriptions" \
  -d '{
    "description": "Payment link status webhook",
    "eventTypes": [
      "payment_link.payment.success",
      "payment_link.payment.failed",
      "payment_link.payment.expired"
    ],
    "target": {
      "url": "https://your-webhook-url.com",
      "method": "POST"
    },
    "isEnabled": true
  }'

const axios = require('axios');
const { v4: uuidv4 } = require('uuid');

function generateBearerToken() {
  // Refer to authentication docs
  return 'YOUR_JWT_TOKEN';
}

async function createPaymentLink(orderData) {
  const response = await axios.post(
    'https://business.coinbase.com/api/v1/payment-links',
    {
      amount: orderData.amount,
      currency: 'USDC',
      network: 'base',
      description: orderData.description,
      successRedirectUrl: orderData.successUrl,
      failRedirectUrl: orderData.failUrl,
      metadata: orderData.metadata
    },
    {
      headers: {
        'Authorization': `Bearer ${generateBearerToken()}`,
        'Content-Type': 'application/json',
        'X-Idempotency-Key': uuidv4()
      }
    }
  );

  return {
    id: response.data.id,
    url: response.data.url,
    expiresAt: response.data.expiresAt
  };
}

async function getStatus(id) {
  const response = await axios.get(
    `https://business.coinbase.com/api/v1/payment-links/${id}`,
    { headers: { 'Authorization': `Bearer ${generateBearerToken()}` } }
  );
  return response.data.status;
}