# Get an add-funds order

Returns an add-funds order of this payment account, with a new `checkout_url`. Call it from your server after the checkout reports a result, and use its `status` as the result. Do not credit the customer on a client-side event alone. When `status` is `paid`, read the balances with Get a payment account.

Endpoint: GET /payment-accounts/{payment_account_id}/orders/{id}
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Path parameters:

  - `payment_account_id` (string, required)
    The ID of a payment account you own. Starts with `pacct_`.

  - `id` (string, required)
    The order ID.

## Response 200:

  - `200` (unknown)
    The order

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier for the order.
    Example: paload_6ab59a06f9xuk

  - `customer_id` (string)
    The customer that owns the payment account.
    Example: cust_6ab599fdEvVur

  - `payment_account_id` (string)
    The payment account that the payment credits.
    Example: pacct_6ab59a10Hk3Zq

  - `status` (string)
    The status of the order.
- `active`
 - the order can be paid.
- `paid`
 - the card payment succeeded. Terminal.
- `partially_paid`
 - part of the amount is paid.
- `under_review`
 - Glomo is reviewing the order.
- `action_required`
 - Glomo needs more information before the order can be paid.
- `failed`
 - the order could not be accepted. Terminal.
- `cancelled`
 - the order was cancelled before it was paid. Terminal.
- `expired`
 - the order was not paid before
`expires_at`
.
    Enum: "active", "paid", "partially_paid", "under_review", "action_required", "failed", "cancelled", "expired"

  - `amount` (integer)
    The amount to add, in minor units of `currency`. `100000` is USD 1,000.00.
    Example: 100000

  - `currency` (string)
    Enum: "USD"

  - `remaining_amount` (integer)
    The amount still to be paid, in minor units.
    Example: 100000

  - `already_paid_amount` (integer)
    The amount already paid, in minor units.
    Example: 0

  - `request_id` (string | null)
    The `request_id` you sent, or `null`.
    Example: acme-load-0001

  - `checkout_url` (string)
    The URL that opens the Glomo checkout for this order. It carries the public key that the checkout needs. Use this URL, or the public key in it, to open the checkout.
    Example: https://api.glomopay.com/api/public/v1/checkout/redirect?resource_id=paload_6ab59a06f9xuk&public_key=live_6ab59a01EXAMPLE1

  - `notes` (object)
    Always an empty object on an add-funds order.
    Example: {}

  - `document_id` (string | null)
    Always `null` on an add-funds order.
    Example: null

  - `purpose_code` (string | null)
    Always `null` on an add-funds order.
    Example: null

  - `invoice_amount` (integer | null)
    Always `null` on an add-funds order.
    Example: null

  - `invoice_description` (string | null)
    Always `null` on an add-funds order.
    Example: null

  - `invoice_number` (string | null)
    Always `null` on an add-funds order.
    Example: null

  - `reference_number` (string | null)
    Always `null` on an add-funds order.
    Example: null

  - `expires_at` (string)
    When the order expires. An add-funds order expires 3 months after it is created.
    Example: 2027-01-15T09:15:42Z

  - `created_at` (string)
    Example: 2026-10-15T09:15:42Z

  - `updated_at` (string)
    Example: 2026-10-15T09:15:43Z

## Response 404:

  - `404` (unknown)
    The account or the order is not found, or the order belongs to another payment account

## Response 404 fields (application/json):

  - `error` (string, required)
    The HTTP reason phrase.
    Example: Bad Request

  - `message` (string, required)
    What went wrong. Show it in logs, not to the customer.
    Example: Payment account cannot send money

  - `code` (string)
    A stable code for the error. Present only on some errors, for example `INSUFFICIENT_BALANCE` on a payout and `order_amount_above_cap` on an order. Branch on `code` when it is present, and on the HTTP status when it is not.
    Example: INSUFFICIENT_BALANCE

