FastJet
POST /v1/payments/new
Bearer

Use this endpoint to create either a Pay-In or Pay-Out transaction. Set payment_type to pay_in for deposits, or pay_out for transfers out.To enable host-to-host (H2H) mode, include the parameter host2host: true in your request body. In H2H mode, card data and payment result are handled server-to-server, response will contain url: null and detailed info.

CRYPTO mode

When mode: "CRYPTO" is used, the client submits a fiat amount (e.g., RUB). The server converts it to USDT at current rates. In responses, all monetary fields (e.g., amount, total, net_processed, fee, commission, gross_amount, shared_commission, paid_amount) are returned in USDT. Exceptions: requested_amount, client_amount, and requested_currency are kept in the original fiat currency provided by the client.

application/json

Body object Required

Schema for creating either a pay-in or pay-out transaction based on payment_type

One of:
PaymentCreatePayInSchema object PaymentCreatePayOutSchema object

Responses

  • 201 application/json

    Payment created successfully.

    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.

  • 409

    If a payment with the same idempotency key exists and was created more than 1 second ago.

  • 455

    Cannot process your payment.

POST /v1/payments/new 
curl \
 --request POST 'https://api.fast-jet.org/v1/payments/new' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"cur":"RUB","mode":"P2P","amount":"1000.00","subtype":"bank_card","user_id":"Tester","callback":"https://{{$merchant_id}}/callback","bank_name":"Other","merchant_id":"YourID1234","payment_type":"pay_in","redirect_url":"https://checkout"}'
Request examples 
{
  "cur": "RUB",
  "mode": "P2P",
  "amount": "1000.00",
  "subtype": "bank_card",
  "user_id": "Tester",
  "callback": "https://{{$merchant_id}}/callback",
  "bank_name": "Other",
  "merchant_id": "YourID1234",
  "payment_type": "pay_in",
  "redirect_url": "https://checkout"
}
{
  "cur": "RUB",
  "mode": "P2P",
  "amount": "1000.00",
  "subtype": "bank_card",
  "user_id": "Tester",
  "callback": "https://my-shop.com/api",
  "bank_name": "Other",
  "host2host": true,
  "merchant_id": "YourID12232427",
  "payment_type": "pay_in",
  "redirect_url": "https://my-shop.com/my-shop"
}
{
  "cur": "RUB",
  "mode": "P2P",
  "amount": "1000.00",
  "subtype": "sbp",
  "user_id": "Tester",
  "callback": "https://{{$merchant_id}}/callback",
  "bank_name": "Other",
  "merchant_id": "YourID1234",
  "payment_type": "pay_in",
  "redirect_url": "https://checkout"
}
{
  "cur": "RUB",
  "mode": "ACQUIRING",
  "amount": "1000.00",
  "subtype": "bank_card",
  "user_id": "Tester",
  "callback": "https://{{$merchant_id}}/callback",
  "bank_name": "Other",
  "merchant_id": "YourID",
  "payment_type": "pay_in",
  "redirect_url": "https://checkout"
}
{
  "cur": "RUB",
  "mode": "CRYPTO",
  "amount": "1000.00",
  "user_id": "{{$uuid}}",
  "callback": "https://{{$merchant_id}}/callback",
  "merchant_id": "{{$uuid}}",
  "payment_type": "pay_in",
  "redirect_url": "https://checkout"
}
{
  "cur": "RUB",
  "mode": "P2P",
  "amount": "2000.00",
  "subtype": "bank_card",
  "user_id": "123456789",
  "callback": "https://webhook.site/fast-jet",
  "description": "Pay out for order #1234",
  "merchant_id": "YourID",
  "payment_type": "pay_out",
  "redirect_url": "https://webhook.site//fast-jet/redirect",
  "pay_out_details": {
    "bank_name": "BANK OTHER",
    "full_name": "Dear. mr John Smith",
    "card_number": "2200154534943708",
    "phone_number": "+700000000000"
  },
  "time_to_complete_payment": 30
}
{
  "cur": "RUB",
  "mode": "ACQUIRING",
  "amount": "5000.00",
  "subtype": "bank_card",
  "user_id": "sfsdfsdf",
  "callback": "https://wrapper.pcigate.tech/sefsef/callback",
  "bank_name": "other",
  "host2host": true,
  "merchant_id": "28xI6702264el9цw3O541",
  "payment_type": "pay_in",
  "redirect_url": "https://shrt.pcigate.tech/esfsfd",
  "pay_in_details": {
    "card": {
      "card_holder": "Василий Александрович",
      "card_number": "2200154534943708",
      "expiry_year": 2035,
      "expiry_month": 7,
      "security_code": "789"
    },
    "bank_name": "other"
  }
}
Response examples (201) 
{
  "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
}
{
  "uid": "0198122932-6f1f-7f64-bcb1-6da501f4717a",
  "url": null,
  "info": {
    "type": "card",
    "card_number": "7466362***74775"
  },
  "state": "idle",
  "amount": "1000.00",
  "fail_by": null,
  "paid_at": null,
  "currency": "RUB",
  "merchant_id": "YourID",
  "created_date": "2025-07-17T16:23:12.419Z",
  "client_amount": null
}
{
  "uid": "01992ecf-91ad-71ce-ae4b-3b7bd43eff7a",
  "url": "https://tst2.voxipay.com/en/pay/10439/394869",
  "info": null,
  "state": "idle",
  "amount": "10.82",
  "fail_by": null,
  "paid_at": null,
  "currency": "USDT",
  "merchant_id": "{{$YourID}}",
  "created_date": "2025-09-09T14:09:39.657Z",
  "client_amount": "1000.00",
  "requested_amount": "1000.00",
  "requested_currency": "RUB"
}