> ## Documentation Index > Fetch the complete documentation index at: https://dev.enterprise.moonpay.com/llms.txt > Use this file to discover all available pages before exploring further. # List card payments ## OpenAPI ````yaml https://api.sandbox.iron.xyz/spec/2025-03-13 get /cards/payments openapi: 3.1.0 info: description: The Stablecoin Payment Network title: Iron API - Sandbox version: '2025-03-13' servers: - url: https://api.sandbox.iron.xyz/api security: [] tags: - description: >- Wallet and bank account registration Every wallet address that interacts with Iron must be registered (linked) to a customer **before** it can be used in any flow — onramp, offramp, or swap. This is a regulatory requirement under the **Travel Rule**, which obliges Virtual Asset Service Providers to exchange originator and beneficiary information for crypto transfers. Iron supports two wallet types: - **Self-hosted wallets** — the customer controls the private key. Registration requires a signed proof-of-ownership message. - **Hosted wallets** — the wallet is custodied by another VASP (e.g. Coinbase, Kraken). Registration requires the VASP's DID so Iron can exchange travel-rule data with the custodian. Similarly, fiat bank accounts must be registered before they can receive offramp payouts. name: Addresses - description: Operations on Autoramp name: Autoramp - description: Cards service operations name: Cards - description: Operations on Chronicle collateral name: ChronicleCollateral - description: Operations on Currencies name: Currencies - description: Operations on Customers name: Customer - description: Operations on Exchange Rate name: ExchangeRate - description: Operations on Fee Profiles name: FeeProfiles - description: Operations for Sandbox Testing name: Sandbox - description: Operations on SSE name: Sse - description: Operations on Terms and Conditions name: TermsAndConditions - description: Operations on Webhooks name: Webhooks paths: /cards/payments: get: tags: - Cards summary: List card payments operationId: listCardPayments parameters: - deprecated: false description: Optional sub-partner UUID; lists that sub-partner's card payments explode: true in: header name: X-SUB-PARTNER-ID required: false schema: type: string - deprecated: false description: Only this customer's payments explode: false in: query name: customer_id required: false schema: default: null format: uuid type: string - deprecated: false description: Only payments made with this card explode: false in: query name: card_id required: false schema: default: null format: uuid type: string - deprecated: false description: 'Paging: the requested page size (max 100)' explode: false in: query name: page_size required: false schema: default: 10 format: uint32 maximum: 100 minimum: 1 type: integer - deprecated: false description: 'Paging: the cursor field from the previous page' explode: false in: query name: cursor required: false schema: default: null format: uuid type: string - $ref: '#/components/parameters/XApiVersion' responses: '200': content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/PagedList_CardPayment' description: '' components: parameters: XApiVersion: description: >- Selects the API version for this request, as an ISO date (`YYYY-MM-DD`). Omit to use the default version (`2025-03-13`). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01, 2026-10-01, 2026-10-15. in: header name: X-API-Version required: false schema: type: string x-default: '2025-03-13' schemas: PagedList_CardPayment: description: | PagedList A list of items with cursors used to fetch the next or previous page properties: cursor: description: The cursor used to fetch the next page type: string items: description: The list of items items: $ref: '#/components/schemas/CardPayment' type: array prev_cursor: default: null description: The cursor used to fetch the previous page type: string required: - items title: PagedList_CardPayment type: object CardPayment: properties: amount: $ref: '#/components/schemas/Amount' card_id: description: The card the payment was made with format: uuid type: string created_at: format: date-time type: string customer_id: description: The customer who made the payment format: uuid type: string expires_at: description: When the authorization hold expires format: date-time type: string id: format: uuid type: string merchant: $ref: '#/components/schemas/CardPaymentMerchant' merchant_amount: $ref: '#/components/schemas/Amount' network: $ref: '#/components/schemas/CardPaymentNetwork' original_amount: $ref: '#/components/schemas/Amount' original_merchant_amount: $ref: '#/components/schemas/Amount' result: $ref: '#/components/schemas/CardPaymentResult' status: $ref: '#/components/schemas/CardPaymentStatus' token_type: $ref: '#/components/schemas/CardPaymentTokenType' updated_at: format: date-time type: string required: - id - customer_id - card_id - status - amount - merchant_amount - merchant - created_at - updated_at title: CardPayment type: object Amount: description: | An amount of money example: amount: '100.5' currency: code: USD type: Fiat properties: amount: description: The amount, a decimal number format: decimal type: string currency: $ref: '#/components/schemas/Currency' required: - amount - currency title: Amount type: object CardPaymentMerchant: properties: acceptor_id: description: The merchant's id at its acquirer type: string acquiring_institution_id: type: string city: type: string country: description: >- ISO 3166-1 alpha-3, plus the networks' `QZZ` (Kosovo) and `ANT` (Netherlands Antilles) type: string descriptor: description: The merchant name as the card network sends it type: string mcc: description: The merchant category code type: string phone_number: type: string postal_code: type: string state: type: string street_address: type: string required: - descriptor - city - country - mcc title: CardPaymentMerchant type: object CardPaymentNetwork: enum: - amex - interlink - maestro - mastercard - unionpay - visa - unknown type: string CardPaymentResult: enum: - approved - declined type: string CardPaymentStatus: enum: - created - pending - cleared - declined - expired - reversed type: string CardPaymentTokenType: description: The digital wallet a payment was made with. enum: - apple_pay - google_pay - masterpass - merchant - samsung_pay - other type: string Currency: anyOf: - $ref: '#/components/schemas/Currency_Crypto' - $ref: '#/components/schemas/Currency_Fiat' description: | Currency Can be either crypto or fiat discriminator: mapping: Crypto: '#/components/schemas/Currency_Crypto' Fiat: '#/components/schemas/Currency_Fiat' propertyName: type type: object Currency_Crypto: allOf: - properties: type: enum: - Crypto example: Crypto type: string required: - type type: object - $ref: '#/components/schemas/Crypto' description: | Currency Can be either crypto or fiat Currency_Fiat: allOf: - properties: type: enum: - Fiat example: Fiat type: string required: - type type: object - $ref: '#/components/schemas/Fiat' description: | Currency Can be either crypto or fiat Crypto: description: A cryptocurrency example: blockchain: Solana token: USDC properties: blockchain: $ref: '#/components/schemas/Blockchain' token: description: The ticker of the token e.g. 'USDC' type: string required: - token - blockchain title: Crypto type: object Fiat: description: A fiat currency example: code: USD properties: code: description: The code of the currency e.g. 'USD' type: string required: - code title: Fiat type: object Blockchain: description: | Blockchain A type of blockchain enum: - Solana - Ethereum - Polygon - Arbitrum - Base - Stellar - Citrea - Plasma - Avalanche - Moca - Monad - Tempo - Tron - Bsc - Seismic - Arc - Optimism - ZeroG type: string ````