Get the status of a previously created payment request

GET /v1/payments/{uid}/status

Retrieve the current status of a payment.

Path parameters

  • uid string(uuid) Required

    FastJet payment UUID

Responses

  • 200 application/json

    Success

    Hide response attributes Show response attributes object
    • uid string(uuid)

      Unique payment identifier

    • url string(uri)

      URL to complete or view the payment

    • merchant_id string

      Identifier of the merchant who initiated the payment

    • state string

      Internal state of the payment.

      • idle — Created. Transaction object exists but not yet started. • routed — The payment has been routed but not yet processed. • completed — The payment has been successfully completed. Final status. • not_fully — The payment is partially paid. Final status. • fail — The payment failed. Final status. • cancel — The payment was reversed or is being reversed. • chargeback — The payment was disputed and charged back. • correction — The payment amount was adjusted up or down.

      Values are idle, routed, completed, not_fully, fail, cancel, chargeback, or correction.

    • payment_type string

      Payment type (e.g., pay_in, pay_out)

    • subtype string

      Payment method used (e.g., bank_card, sbp)

    • requested_amount string

      Original fiat amount provided by the client.

    • requested_currency string

      Original fiat currency provided by the client (ISO 4217).

    • client_amount string

      Amount shown or entered by the client in the original currency. In CRYPTO mode remains in fiat.

    • amount string

      Converted amount processed. In CRYPTO mode — expressed in USDT.

    • currency string

      Currency of processed amounts.

    • total string

      Total amount including fees and commissions

    • net_processed string

      Net amount processed after fees

    • fee string

      Service fee amount

    • commission string

      Commission charged by payment processor

    • gross_amount string

      Gross amount before deductions

    • shared_commission string

      Portion of commission shared between partners

    • paid_amount string

      Amount paid out to the recipient (renamed from payed_amount).

    • fail_by string

      Entity responsible for failure, in created transaction - null

    • fail_code string

      Error code if payment failed

    • receipts array[string(uri)]

      List of URLs to payment receipts

    • created_date string(date-time)

      Timestamp when payment was created

    • paid_at string(date-time)

      Timestamp when payment was completed

    • redirect_url string(uri)

      URL for client redirection after payment

    • form string

      Form type used for payment (e.g., acquiring.card)

    • info object

      Additional information or comments

  • 401

    Authorization required.

  • 404

    Payment with the given ID not found.

GET /v1/payments/{uid}/status
curl \
 --request GET 'https://api.fast-jet.org/v1/payments/{uid}/status' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "uid": "0198331929-e37f-7914-9bc7-e33b53f379bc",
  "url": "https://example/cmd7lb2xr002341s79nwhlvob2su/form",
  "info": null,
  "state": "idle",
  "amount": "1000.00",
  "fail_by": null,
  "paid_at": null,
  "currency": "RUB",
  "merchant_id": "YourID",
  "created_date": "2025-07-17T16:13:52.386Z",
  "client_amount": null
}