Payment

A Payment object represents a single financial transaction - either a one-time purchase or a recurring subscription charge. Payments track the monetary flow, including the amount, fees, tax, and processing status. Each payment is associated with an Order and optionally with a User and Subscription. Payments contain detailed information about charges, including payment method details and invoice data when applicable.

Endpoints

Method	Endpoint	Description
`GET`	`/v0/payments/list`	List and filter payments
`GET`	`/v0/payments/{paymentId}`	Retrieve a payment by ID

The Payment object

string

Object type identifier. Always "payment" for Payment objects.

string

required

Unique identifier (UUID) for this payment.

string

required

Human-readable payment number (e.g., #ABC123DEF456). Used for reference in invoices and support.

string

required

Type of payment. Possible values: one_time, subscription_initial, subscription_update, subscription_interval, subscription_extra, claim_free

string

required

Current payment status. Possible values: PENDING, PAID, FAILED, UNPAID, CANCELLED, REFUNDED, PARTIALLY_REFUNDED, EXPIRED

integer

Payment amount in the smallest currency unit (e.g., cents for USD). Includes tax but excludes fees. Defaults to 0.

integer

Tax amount in the smallest currency unit. Included in the total value. Defaults to 0.

integer

Processing fee in the smallest currency unit. This is deducted from your payout. Defaults to 0.

string | null

Three-letter ISO 4217 currency code (e.g., "USD", "EUR", "GBP").

integer | null

Number of decimal places for this currency (e.g., 2 for USD, 0 for JPY).

integer

Unix timestamp (milliseconds) when the payment was created.

string | null

UUID of the User who made this payment.

User | null

Expanded User object with basic information about the payer.

Show user properties

string

Always "user".

string

required

Unique identifier (UUID) for this user.

string | null

Username of the user.

string | null

UUID of the associated Order. For subscription payments, this links to the initial order.

string | null

Human-readable order number of the associated order.

Order | null

Expanded Order object with basic information.

Show order properties

string

Always "order".

string

required

Unique identifier (UUID) for this order.

string

required

Human-readable order number.

string

required

Current order status.

string | null

Subscription identifier if this is a subscription-related payment.

Subscription | null

Expanded Subscription object with status and ID.

Show subscription properties

string

Always "subscription".

string

required

Subscription identifier.

string

required

Subscription status: active, past_due, canceled, unpaid, incomplete, incomplete_expired, trialing, paused

Discount | null

Applied Discount object if a discount code or sale was used.

Show discount properties

string

Always "discount".

string

required

Unique identifier (UUID) for this discount.

string

required

Discount type: code or sale.

string | null

Display name of the discount.

number

required

Discount amount (fixed value or percentage).

string

required

Whether amount is fixed or percentage.

string | null

The coupon code if this is a code-type discount.

string | null

Invoice number for completed payments. Only available for PAID, REFUNDED, or PARTIALLY_REFUNDED statuses.

string | null

URL to download the invoice PDF. Only available for completed payments with generated invoices.

array | null

Array of charge attempts for this payment.

Show charge properties

string

Always "charge".

string

required

Unique identifier (UUID) for this charge.

string | null

Charge status: succeeded, pending, failed

number | null

Unix timestamp (milliseconds) when the charge was created.

string | null

IP address of the customer at time of charge.

object | null

Payment method details including type, brand, last4, and card.

Show child attributes

string

Payment method type (e.g., card, paypal, bank_transfer, klarna, affirm).

string | null

Card brand if payment method is a card (visa, mastercard, amex, discover, diners, jcb, unionpay).

string | null

Last 4 digits of the card or account number.

object

Card-specific payment details. Present when the payment method type is card.

Show child attributes

string | null

Card brand (visa, mastercard, amex, discover, diners, jcb, unionpay).

string | null

Last 4 digits of the card number.

string | null

Two-letter ISO country code of the card issuer.

string | null

Card network (e.g., visa, mastercard).

object | null

Digital wallet details, if the card payment was made via a wallet (e.g., Apple Pay, Google Pay). Null when no wallet was used.

Show child attributes

string

The type of digital wallet: amex_express_checkout, apple_pay, google_pay, link, masterpass, samsung_pay, or visa_checkout.

string | null

The last four digits of the device account number. May differ from the physical card’s last4.

Example response

{
  "status": "success",
  "data": {
    "payment": {
      "object": "payment",
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "number": "#PAY123DEF456",
      "type": "one_time",
      "status": "PAID",
      "value": 2999,
      "tax": 500,
      "fee": 87,
      "currency": "USD",
      "currencyDecimals": 2,
      "createdAt": 1705590000000,
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "user": {
        "object": "user",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "username": "johndoe"
      },
      "orderId": "550e8400-e29b-41d4-a716-446655440000",
      "orderNumber": "#ABC123DEF456",
      "order": {
        "object": "order",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "number": "#ABC123DEF456",
        "status": "PAID"
      },
      "subscriptionId": null,
      "subscription": null,
      "discount": null,
      "invoiceNumber": "INV-2024-001234",
      "invoiceUrl": "https://api.fungies.io/invoice/INV-2024-001234",
      "charges": [
        {
          "object": "charge",
          "id": "770e8400-e29b-41d4-a716-446655440002",
          "status": "succeeded",
          "createdAt": 1705590000000,
          "ipAddress": "192.168.1.100",
          "paymentMethod": {
            "type": "card",
            "brand": "visa",
            "last4": "4242",
            "card": {
              "brand": "visa",
              "last4": "4242",
              "country": "US",
              "network": "visa",
              "wallet": {
                "type": "apple_pay",
                "dynamicLast4": "7279"
              }
            }
          }
        }
      ]
    }
  }
}

Orders

Orders associated with payments

Users

Customers who made payments

Subscriptions

Recurring subscription payments

Discounts

Discounts applied to payments

Getting Started

Customers

Commerce

Transactions

Webhooks

Endpoints

The Payment object

Example response

Orders

Users

Subscriptions

Discounts

​Endpoints

​The Payment object

​Example response

​Related resources

Orders

Users

Subscriptions

Discounts

Endpoints

The Payment object

Example response

Related resources