Transaction

A transaction representing a crypto purchase or sale

Properties

Property	Type	Required	Description
id	string	Yes	The MoonPay ID of the transaction
createdAt	string (date-time)	Yes	ISO 8601 timestamp of when the transaction was created
updatedAt	string (date-time)	Yes	ISO 8601 timestamp of when the transaction was last updated
status	string	Yes	The current status: completed, failed, or pending
source	object	Yes	The source amount and asset (fiat currency)
destination	object	Yes	The destination amount and asset (cryptocurrency)
fees	Fees	Yes	Fee breakdown for the transaction
wallet	Wallet	Yes	The wallet where crypto was delivered
customer	object	Yes	The customer who made the transaction
paymentMethod	object	No	The payment method used
stages	array	No	The stages of the transaction lifecycle

Source / Destination

Both source and destination have the same structure:

Property	Type	Required	Description
amount	string	Yes	The amount as a string to preserve precision
asset	Asset	Yes	The currency or token

Customer

Property	Type	Required	Description
id	string	Yes	The MoonPay ID of the customer

Transaction Status

Value	Description
pending	Transaction is in progress
completed	Transaction completed successfully
failed	Transaction failed

Example

{
  "id": "tr_abc123",
  "createdAt": "2026-01-29T14:30:50.000Z",
  "updatedAt": "2026-01-29T15:30:50.000Z",
  "status": "completed",
  "source": {
    "amount": "100.00",
    "asset": {
      "code": "USD"
    }
  },
  "destination": {
    "amount": "0.0025",
    "asset": {
      "code": "ETH"
    }
  },
  "fees": {
    "network": {
      "amount": "2.50",
      "currencyCode": "USD"
    },
    "moonpay": {
      "amount": "3.99",
      "currencyCode": "USD"
    }
  },
  "wallet": {
    "address": "0x1234...abcd"
  },
  "customer": {
    "id": "cust_xyz789"
  },
  "paymentMethod": {
    "type": "apple_pay"
  }
}