ALalfredpay
Sandbox

Activate a destination instantly (sandbox only)

Changed on

Moves the relationship to VERIFIED without waiting on the review queue, which is the one step of a payout whose timing you otherwise can't control.

Exists on the sandbox host only. On production the path returns 404 not_found.

Idempotency-Key is required. A replay returns the same already-verified account.

Fires linked_account.updated. See Webhooks and events.

post/v1/test/linked_accounts/{linkedAccountId}/simulate_activation

Request

  • Base URL
    https://api.sandbox.alfredpay.io
  • URL
    https://api.sandbox.alfredpay.io/v1/test/linked_accounts/{linkedAccountId}/simulate_activation
  • Auth
    • HTTP bearer
    • or API key in header api-key and API key in header api-secret

Headers

Idempotency-Keystring uuid required

Required on every state-changing POST, simulators included; the only exempt POST is …/verifications/preflight. Replay (same key, same body) returns the original response with Idempotent-Replayed: true; same key with a different body → 409 idempotency_conflict. Keys are UUIDs, scoped to the API key, retained for 24 hours.

Response

OK

idstring
customerIdstring
destinationType'BANK_ACCOUNT' | 'WALLET'

What kind of thing the money lands in. Kept separate from the rail (how it gets there) and from the provider (who carries it).

country'MEX' | 'ARG' | 'BRA' | 'COL' | 'CHL' | 'PER' | 'DOM' | 'USA' | 'CHN' | 'HKG' | 'BOL' | 'PRY'

ISO 3166-1 alpha-3, the only form Alfred stores, filters on, reports or emits. Compatibility rule for integrations that can only send alpha-2: any inbound country value in alpha-2 (path, query or body) is normalized to alpha-3 at the boundary before validation, storage or routing. Unrecognized in either form → 422 validation_error.

currency'USD' | 'HKD' | 'CNY' | 'MXN' | 'DOP' | 'COP' | 'BRL' | 'ARS' | 'CLP' | 'PEN' | 'BOB' | 'PYG' | 'USDC' | 'USDT'

Fourteen members, reconciled to the countries a customer can be onboarded in. USDC and USDT are stablecoins and require chain.

supportedRailsRail[]

Derived by Alfred at registration from country and identifier type. A payout or quote must use one of these.

identifierTypestring nullable
identifierMaskedstring nullable

Last four characters only.

holderNamestring
createdAtstring date-time

Changes