Transaction

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`	Stage[]	No	Pipeline stages for the buy lifecycle, including per-stage `failureReason` when a stage fails
`bankTransferDepositInfo`	object	No	Bank account details and payment reference for completing a bank transfer. Present only on bank-transfer transactions (SEPA). See Bank transfer deposit info.

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

Stages

Buy transactions return a stages array that breaks the pipeline into steps (ordering, verification, payment, delivery, and others depending on the payment method). Poll the transaction after checkout to see which stage failed and read stages[].failureReason for a machine-readable code. See the Stage object and Stage failure reasons catalog.

Bank transfer deposit info

Bank-transfer payments (SEPA) settle when the customer sends funds to a MoonPay bank account. For these transactions, the response includes a bankTransferDepositInfo object with the account details and the payment reference. Render these details in your own UI so the customer can complete the transfer, then poll the transaction until it reaches a terminal status. Bank-transfer transactions stay pending until the customer’s funds arrive.

Property	Type	Required	Description
`reference`	string	Yes	The payment reference the customer must include with the transfer.
`recipientName`	string	Yes	The name of the recipient that receives the funds.
`recipientAddress`	string	Yes	The address of the recipient.
`iban`	string	No	The IBAN. Provided for SEPA (EUR).
`bic`	string	No	The BIC (SWIFT code). Provided for SEPA (EUR).
`bankName`	string	No	The name of the receiving bank.
`bankAddress`	string	No	The address of the receiving bank.

The customer must always include the payment reference. Transfers sent without the reference are rejected.

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"
  }
}

Documentation

Sessions

Customers

Payment Methods

Assets

Quotes

Transactions

Webhooks

Objects & Types

Properties

Source / Destination

Customer

Transaction Status

Stages

Bank transfer deposit info

Example

​Properties

​Source / Destination

​Customer

​Transaction Status

​Stages

​Bank transfer deposit info

​Example

Properties

Source / Destination

Customer

Transaction Status

Stages

Bank transfer deposit info

Example