Integrations API

Manage payment provider connections programmatically.

List Integrations

GET /v1/integrations

curl

curl -X GET https://api.gopaylocal.com/v1/integrations \
  -H "Authorization: Bearer gpl_sk_live_xyz789"

JavaScript

const res = await fetch('https://api.gopaylocal.com/v1/integrations', {
  headers: { 'Authorization': 'Bearer gpl_sk_live_xyz789' },
});
const { data } = await res.json();

Response:

{
  "data": [
    {
      "id": "int_abc123",
      "provider": "stripe",
      "status": "connected",
      "environment": "live",
      "createdAt": "2025-01-15T10:30:00Z",
      "lastSyncAt": "2025-01-20T14:22:00Z"
    }
  ]
}

Connect Integration

POST /v1/integrations

curl

curl -X POST https://api.gopaylocal.com/v1/integrations \
  -H "Authorization: Bearer gpl_sk_live_xyz789" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "stripe",
    "apiKey": "sk_live_xxx",
    "environment": "live"
  }'

JavaScript

const res = await fetch('https://api.gopaylocal.com/v1/integrations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer gpl_sk_live_xyz789',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    provider: 'stripe',
    apiKey: 'sk_live_xxx',
    environment: 'live',
  }),
});

Request Body:

Field	Type	Required	Description
provider	string	Yes	Provider name: stripe, paddle, dodo, lemon_squeezy, gumroad, chargebee, whop, polar
apiKey	string	Yes	Provider API key
environment	string	No	"live" or "test" (default: "live")
siteName	string	No	Required for Chargebee (subdomain)

Disconnect Integration

DELETE /v1/integrations/:id

curl

curl -X DELETE https://api.gopaylocal.com/v1/integrations/int_abc123 \
  -H "Authorization: Bearer gpl_sk_live_xyz789"

JavaScript

await fetch('https://api.gopaylocal.com/v1/integrations/int_abc123', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer gpl_sk_live_xyz789' },
});

Response: 204 No Content

Caution

Disconnecting an integration does not delete discount codes from the provider. You may want to clean up manually if needed.

Sync Discounts

Trigger a manual sync of discount codes with the connected provider.

POST /v1/integrations/:id/sync

curl -X POST https://api.gopaylocal.com/v1/integrations/int_abc123/sync \
  -H "Authorization: Bearer gpl_sk_live_xyz789"

This creates or updates discount codes in the payment provider based on your current parity groups and campaign settings.

Test Connection

Verify that the integration’s API key is valid.

POST /v1/integrations/:id/test

Response (success):

{
  "ok": true,
  "message": "Connection successful"
}

Response (failure):

{
  "ok": false,
  "message": "Authentication failed — check your API key"
}

List Provider Products

Fetch products from the connected payment provider. Currently supported by Dodo Payments.

GET /v1/integrations/:id/products

curl

curl -X GET https://api.gopaylocal.com/v1/integrations/int_abc123/products \
  -H "Authorization: Bearer gpl_sk_live_xyz789"

JavaScript

const res = await fetch('https://api.gopaylocal.com/v1/integrations/int_abc123/products', {
  headers: { 'Authorization': 'Bearer gpl_sk_live_xyz789' },
});
const { data } = await res.json();

Response:

{
  "data": [
    {
      "providerProductId": "prod_abc123",
      "name": "Pro Plan",
      "price": 29.99,
      "currency": "USD",
      "url": "https://dodopayments.com/products/prod_abc123"
    }
  ]
}

Note

Prices are returned in major currency units (e.g., dollars, not cents). Zero-decimal currencies like JPY are returned as-is.

Import Products

Import selected products from the payment provider into GoPayLocal.

POST /v1/integrations/:id/products/import

Request Body:

{
  "productIds": ["prod_abc123", "prod_def456"]
}

Response:

{
  "data": {
    "imported": 2
  }
}

Duplicate products (matching by URL) are automatically skipped.