Payment Management

Overview

Query saved payment methods (cards, bank accounts) for your account. Payment tokens are added and managed via the Terminal UI — this API provides read-only access for listing tokens and referencing them in conditional bids.

List Payment Tokens

query GetPaymentTokens($input: GetPaymentTokenInput!) {
  getPaymentTokens(input: $input) {
    paymentTokens {
      id
      paymentMethodType
      lastFour
      cardType
      expiryMonth
      expiryYear
      routingNumber
      isDefault
      nickname
      lastUsedAt
      createdAt
    }
    pagination {
      totalCount
      limit
      offset
      hasNextPage
    }
    error { message code }
  }
}

Field	Type	Required	Description
tokenId	String	No	Get a specific token by ID
getDefault	Boolean	No	Get only the default payment method
pagination	SimplePaginationInput	No	{ limit, offset } — defaults to limit 20, offset 0

List All Tokens

{
  "query": "query GetPaymentTokens($input: GetPaymentTokenInput!) { getPaymentTokens(input: $input) { paymentTokens { id paymentMethodType lastFour cardType isDefault nickname } pagination { totalCount hasNextPage } error { message code } } }",
  "variables": {
    "input": {}
  }
}

Get Default Token

{
  "query": "query GetPaymentTokens($input: GetPaymentTokenInput!) { getPaymentTokens(input: $input) { paymentToken { id paymentMethodType lastFour cardType isDefault nickname } error { message code } } }",
  "variables": {
    "input": {
      "getDefault": true
    }
  }
}

Get Specific Token

{
  "query": "query GetPaymentTokens($input: GetPaymentTokenInput!) { getPaymentTokens(input: $input) { paymentToken { id paymentMethodType lastFour cardType expiryMonth expiryYear isDefault nickname lastUsedAt } error { message code } } }",
  "variables": {
    "input": {
      "tokenId": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
}

PaymentTokenEntity Type

Field	Type	Description
id	ID!	Unique identifier
accountId	ID!	Account that owns this token
paymentProviderId	ID!	Payment provider (Coinflow, Stripe, etc.)
paymentMethodType	PaymentMethodType!	CARD or BANK_ACCOUNT
lastFour	String	Last 4 digits of card or account number
cardType	String	Card brand: visa, mastercard, amex, discover (null for bank accounts)
expiryMonth	String	Card expiry month MM (null for bank accounts)
expiryYear	String	Card expiry year YYYY (null for bank accounts)
routingNumber	String	Routing number (null for cards)
isDefault	Boolean!	Whether this is the default payment method
nickname	String	User-friendly name (e.g., "Work Card", "Main Checking")
lastUsedAt	String	Last time this method was used
createdAt	String!	Created timestamp
updatedAt	String!	Last modified timestamp

Using Payment Tokens with Conditional Bids

Assign a saved payment token to a conditional bid using paymentTokenId. When the bid wins, that payment method is charged instead of the account default.

{
  "input": {
    "assetType": "TICKET",
    "bidAmountCents": 15000,
    "paymentTokenId": "550e8400-e29b-41d4-a716-446655440000",
    "conditions": [...]
  }
}

See Conditional Bidding for full details.

Payment Resolution Order

Priority	Scope	Description
Highest	Conditional Bid	paymentTokenId on the conditional bid
Lowest	Account Default	Default payment token (isDefault: true)

Managing Payment Methods

Payment methods are added, updated, and deleted via the Terminal UI:

1. Log in to your dashboard
2. Navigate to Payment Methods
3. Add, edit, or remove cards and bank accounts

---

← Address Management | Conditional Bidding →

© 2026 Tradepost Markets Inc. All rights reserved.