Transactions

Retrieve a payment leg

Changed on

Returns one leg with its current leg_status and settlement_status, its provider reference, and the destination_control_type that drives Travel Rule, KYT and ownership checks.

get/v1/legs/{legId}

Request

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

Response

OK

leg_idstring
parent_transaction_idstring
leg_type'LP_EXECUTION' | 'ASSET_MOVEMENT' | 'FIAT_RAIL' | 'LEDGER_ENTRY' | 'CORRECTION_LEG'
providerstring
provider_referencestring nullable

Preserved as received, never overwritten.

chain_tx_hashstring nullable
destination_control_type'ALFRED_CONTROLLED' | 'EXTERNAL_CUSTOMER_WALLET' | 'EXTERNAL_CUSTOMER_ACCOUNT' | 'EXTERNAL_UNKNOWN' | 'null' nullable
leg_status'CREATED' | 'SUBMITTED_TO_PROVIDER' | 'ACCEPTED_BY_PROVIDER' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'RETURNED' | 'REVERSED'
settlement_status'NOT_STARTED' | 'FUNDS_EXPECTED' | 'FUNDS_RECEIVED' | 'FUNDS_HELD' | 'FUNDS_RELEASED' | 'SETTLED' | 'PARTIALLY_SETTLED' | 'FAILED' | 'RETURNED'

Leg-level and financial. "Delayed settlement" is a settlement value with the parent still PROCESSING, never a business status.

amountstring
currencystring

Changes