PayLink

Changelog

API & SDK release notes — versions, dates, and what changed.

Versions

  1. 2026-10-20.genesis

    Connect products, Sub-Platforms, Liquidity Engine

    Payment routes move to /api/connect/* and /api/liquidity. No legacy paths.

    Breaking changes

    The payment products now have one prefix each. The old paths were removed, with no alias and no transition period: they return 404. Update your integration, SDK version and MCP tools.

    ProductNew prefix
    Connect Ramp/api/connect/ramp
    Connect Treasury/api/connect/treasury
    Connect Commerce/api/connect/commerce
    Sub-Platforms/api/connect/sub-platforms
    Liquidity Engine (ex Treasury Engine)/api/liquidity

    Every route also answers under the train alias /api/genesis/.... On api.openconnect.cc, /connect/* is /api/connect/*.

    One API for every brand

    /api/paylink, /api/connectpay, /api/shogun and /api/openconnect/ocpay are gone. The brand comes from the Connect-Brand header (connectpay | paylink | shogun), then from the request domain, then defaults to Connect Pay. See Brands.

    Old → new

    … is any of the old brand mounts (/api/paylink, /api/connectpay, /api/shogun, /api/openconnect/connectpay, /api/openconnect/ocpay).

    OldNew
    …/ramp/*, …/sessions/*, …/onramp/*, …/offramp/*, …/catalog/*, …/network/*/api/connect/ramp/{same}/*
    …/platform/*, /api/external-providers/paylink/fintech/*/api/connect/ramp/settings/*
    /api/external-providers (status, /registry, /{slug})/api/connect/ramp/providers
    /api/offramp/* (consumer)/api/connect/ramp/consumer-offramp/*
    …/treasury/*/api/connect/treasury/accounts/*
    …/transfers/*, …/send/*, …/convert/*, …/billing/*/api/connect/treasury/{same}/*
    …/payment/*/api/connect/treasury/payment-requests/*
    …/subscription/*/api/connect/treasury/subscriptions/*
    …/customer/*/api/connect/treasury/customer-portal/*
    …/checkout/*, …/qr-pay/*, …/collections/*, …/pos/*, …/public/*/api/connect/commerce/{same}/*
    …/marketplace/* (escrow)/api/connect/commerce/escrow/*
    /api/extra-tools/qr/*/api/connect/commerce/qr/*
    /api/fulfillment/*/api/connect/commerce/orders/*
    /api/ultravault/instruments/gift-cards/*/api/connect/commerce/gift-cards/*
    /api/external-providers/linkinbio/*/api/connect/commerce/link-in-bio/*
    /api/openconnect/open-{kiosk,shop,eat,drive,cashout,marketplace}/*/api/connect/commerce/{kiosk,shop,eat,drive,cashout,marketplace}/*
    /api/openconnect/ocplatform/sub-platforms/*/api/connect/sub-platforms/*
    /api/openconnect/ocplatform/connect/*/api/connect/sub-platforms/onboarding/*
    …/business/* (Sub-Platform key)the product routes, with the Sub-Platform key (see below)
    …/protocol/ops/*/api/admin/sub-platforms/* (admin key)
    /api/treasury/engine/*/api/liquidity/engine/*

    Sub-Platforms replace business accounts

    • A business that needs its own platform, key and checkout is a Sub-Platform of its fintech or platform. It authenticates with its Sub-Platform key (oc_live_*); gr_live_biz_* keys no longer exist.
    • Managed business accounts are removed. A subsidiary is a Sub-Platform with relation: subsidiary (relation: customer for an independent client).
    • sub_profile_type is standard or custom; express is refused.
    • Businesses see Connect Business (platform.openconnect.cc), PayLink Business (platform.paylink.business) or Shogun Business (platform.shogun.cash), by Open Connect.

    A Sub-Platform calls the product routes

    There is no separate path for a business. It calls the same route as its fintech, with its own key (oc_live_*); the key decides the scope (its payments module). A path that is not open to a Sub-Platform key answers 404 (ROUTE_NOT_AVAILABLE_FOR_SUB_PLATFORM_KEY). /api/connect/sub-platforms/merchant/* and /api/connect/sub-platforms/ops/* are removed.

    Old (/api/connect/sub-platforms/merchant/…)New (Sub-Platform key)
    core/payment-requests/api/connect/treasury/payment-requests/core
    core/ramp/{links,operations,embed-token}/api/connect/ramp/core/{links,operations,embed-token}
    protocol/ramp/settings/api/connect/ramp/settings (GET, PUT)
    protocol/portal-payment-methods/api/connect/commerce/payment-methods
    protocol/webhooks/*/api/webhooks/*
    protocol/me, protocol/api-keys/rotate/api/openconnect/ocplatform/me, /api/openconnect/ocplatform/api-keys/rotate
    portal/* (member JWT)/api/openconnect/ocplatform/portal/*
    ops/ramp/platforms/{platformId}/*, ops/business/*/api/admin/sub-platforms/ramp/platforms/{platformId}/*, /api/admin/sub-platforms/merchants/* (admin key)

    Webhook fix. A business's webhooks used to be stored on its parent fintech, so a Sub-Platform could read and change its fintech's subscriptions. A Sub-Platform key now manages its own subscriptions on /api/webhooks, and the events of its payments module are sent to them.

    SDK: connect.subPlatforms.merchant.* and protocol.subPlatforms.* are removed. Use connect.treasury.paymentRequests, connect.ramp.core, connect.ramp.settings.get/update, connect.commerce.paymentMethods, fintech.webhooks, openconnect.platform.getMe/rotateApiKey, openconnect.platform.portal and, with an admin key, admin.subPlatforms.{ramp,merchants}. See Same routes, your own key.

    Webhook events renamed

    Existing subscriptions are renamed in place.

    OldNew
    paylink.session.{created,processing,completed,failed,cancelled}connect.ramp.session.*
    paylink.intent.{bound,confirmed,failed,cancelled,expired}connect.ramp.intent.*
    paylink.payment_link.paidconnect.commerce.payment_link.paid
    paylink.transfer.completedconnect.treasury.transfer.completed
    paylink.treasury.{credited,debited}connect.treasury.{credited,debited}
    payment.succeeded (alias)removed

    Catalog categories: paylink → connect, paylink_ramp → connect_ramp.

    Removed

    PayLink Ramp is no longer a product (PayLink is a brand of Connect Ramp). Open Pay is the Connect Pay brand. Open Delivery is removed (delivery goes through Connect Drive).

  2. 2026-07-24.genesis

    Genesis baseline

    Initial public API and SDK surface for the genesis train.

    What's new

    First dated release of the GoldRail public API (Goldrail-Version: 2026-07-24.genesis).

    Highlights

    • Public REST surface across products (PayLink, OpenConnect, UltraVault, Gateway, …)
    • Version header support via Goldrail-Version
    • TypeScript SDK @goldrail/sdk aligned with genesis mounts

    Example

    import { GoldRailClient } from '@goldrail/sdk';

const client = new GoldRailClient({
  apiKey: 'grk_live_...',
  baseUrl: 'https://api.goldrail.xyz',
});

    Media

    You can embed images, GIFs, and videos in any changelog entry:

    Banner

    <video controls playsInline src="/assets/videos/example.mp4" />