LIlightsparkdev
Stablecoins

Link a stablecoin provider account

Changed on

Link provider API credentials for the authenticated platform. Provider credentials are account-scoped and can be reused for multiple stablecoins. Currently, the only supported provider is BRALE; the provider environment is derived from the authenticated Grid platform mode.

post/stablecoin-provider-accounts

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/stablecoin-provider-accounts
  • Auth
    HTTP basic

Headers

Idempotency-Keystring required

Idempotency key for retrying this request safely. Replays return the prior result; conflicting payloads are rejected.

Request body

provider'BRALE' required

Stablecoin provider backing the linked account, stablecoin, or operation.

apiClientIdstring required

Provider API client id used to verify and link the provider account.

apiClientSecretstring required

Provider API client secret. Grid verifies and stores this secret encrypted; it is never returned.

providerAccountIdstring

Provider account id. Optional when the submitted credentials expose exactly one provider account.

Example request

{
  "apiClientId": "provider_client_123",
  "apiClientSecret": "provider_secret_456",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4"
}

Response

Stablecoin provider account linked

idstring required

System-generated stablecoin provider account link identifier.

provider'BRALE' required

Stablecoin provider backing the linked account, stablecoin, or operation.

providerAccountIdstring required

Provider account id.

providerEnvironment'SANDBOX' | 'PRODUCTION' required

Provider environment derived from the authenticated Grid platform mode.

status'ACTIVE' | 'INVALID' | 'REVOKED' required

Status of the linked stablecoin provider account credentials.

lastVerifiedAtstring date-time

Timestamp of the last successful provider credential verification.

createdAtstring date-time required

Creation timestamp.

updatedAtstring date-time required

Last update timestamp.

Example response

{
  "id": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
  "lastVerifiedAt": "2026-05-20T16:35:00Z",
  "createdAt": "2026-05-20T16:35:00Z",
  "updatedAt": "2026-05-20T16:35:00Z"
}

Changes

  • d996ddfb9d2bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • f11f1e76bdd7Revision changes
    • warning

      added the new PURCHASE_CARD_LIMIT_REACHED enum value to the response property for the response status