Creating a payment request

Payment requests are created based on an amount in pesos and contain information about the exchange rate of the order in each available currency for making the payment. To initiate a payment, it is necessary to first create the payment request.

The route for creating them receives an amount in pesos and the accepted currencies, and the backend calculates the exchange rate for each currency and stores it in the database. The SimpleFi system listens to the blockchains of all accepted currencies and updates payment requests when the corresponding payments are found.

To create a payment request:

Create Payment Request

post

Authorizations

OAuth2PasswordBearerExtended

OAuth2passwordRequired

Token URL:

Body

application/json

ars_amountany ofOptional

numberOptional

or

nullOptional

amountany ofOptional

numberOptional

or

nullOptional

currencyany ofOptional

string · enumOptionalPossible values:

or

nullOptional

itemsany ofOptional

or

nullOptional

memoany ofOptional

stringOptional

or

nullOptional

coinsany ofOptional

or

nullOptional

card_paymentany ofOptionalDefault: false

booleanOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

merchant_idany ofOptional

anyOptional

or

nullOptional

Responses

201

Successful Response

application/json

idstringRequired

order_idintegerRequired

ars_amountnumberRequired

ars_paidnumberRequired

amountnumberRequired

original_amountany ofOptional

numberOptional

or

nullOptional

card_amountany ofOptional

numberOptional

or

nullOptional

amount_paidnumberRequired

currencystring · enumRequiredPossible values:

itemsany ofOptional

or

nullOptional

usd_amountnumberRequired

memoany ofOptional

stringOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

statusstring · enumRequiredPossible values:

status_detailstring · enumRequiredPossible values:

approved_atany ofOptional

string · date-timeOptional

or

nullOptional

expiration_timestring · date-timeRequired

deliveredbooleanRequired

card_paymentany ofOptional

or

nullOptional

stripe_invoiceany ofOptional

or

nullOptional

merchant_idstringRequired

installment_plan_idany ofOptional

stringOptional

or

nullOptional

pricing_modestring · enumOptionalDefault: crypto_basePossible values:

crypto_discountnumberOptionalDefault: 0

extra_chargenumberOptionalDefault: 0

is_remaining_balance_paymentbooleanOptionalDefault: false

poap_mintedbooleanOptionalDefault: false

offramp_statusany ofOptional

stringOptional

or

nullOptional

offramp_dataany ofOptional

or

nullOptional

date_createdstring · date-timeRequired

last_modifiedstring · date-timeRequired

checkout_urlstringRead-onlyRequired

checkout_v2_urlstringRead-onlyRequired

conflictbooleanRead-onlyRequired

422

Validation Error

application/json

post

/payment_requests

HTTPcURLJavaScriptPython

POST /payment_requests HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 309

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "card_payment": false,
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "notification_url": "text",
  "merchant_id": null
}

{
  "id": "text",
  "order_id": 1,
  "ars_amount": 1,
  "ars_paid": 1,
  "amount": 1,
  "original_amount": 1,
  "card_amount": 1,
  "amount_paid": 1,
  "currency": "ARS",
  "items": [
    {
      "id": "text",
      "quantity": 1,
      "name": "text",
      "price": 1,
      "currency": "ARS"
    }
  ],
  "usd_amount": 1,
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "notification_url": "text",
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "status": "pending",
  "status_detail": "not_paid",
  "approved_at": "2026-03-19T08:36:40.234Z",
  "expiration_time": "2026-03-19T08:36:40.234Z",
  "delivered": true,
  "transactions": [
    {
      "id": "text",
      "price_details": {
        "currency": "ARS",
        "currency_amount": 1,
        "currency_final_amount": 1,
        "base_amount": 1,
        "final_amount": 1,
        "paid_amount": 1,
        "discount_rate": 1,
        "rate": 1
      },
      "coin": "BTC",
      "chain_id": 1,
      "address": "text",
      "status": "not_paid",
      "payment_request_id": "text",
      "memo": "text",
      "additional_info": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "payments": [
        {
          "hash": "text",
          "from": "text",
          "chain_id": 1,
          "block": 1,
          "amount": 1,
          "paid_by": "text",
          "paid_at": "2026-03-19T08:36:40.234Z",
          "linked_at": "2026-03-19T08:36:40.234Z"
        }
      ],
      "date_created": "2026-03-19T08:36:40.234Z",
      "last_modified": "2026-03-19T08:36:40.234Z"
    }
  ],
  "card_payment": {
    "provider": "stripe",
    "session_url": "text",
    "payment_intent_id": "text",
    "price_details": {
      "currency": "ARS",
      "amount": 1,
      "final_amount": 1,
      "usd_final_amount": 1,
      "paid_amount": 1,
      "discount_rate": 1,
      "rate": 1
    },
    "status": "not_paid",
    "card_last4": "text",
    "card_brand": "text",
    "date_created": "2026-03-19T08:36:40.234Z",
    "last_modified": "2026-03-19T08:36:40.234Z"
  },
  "stripe_invoice": {
    "invoice_id": "text",
    "subscription_id": "text",
    "invoice_number": "text",
    "invoice_url": "text",
    "invoice_pdf": "text",
    "period_start": "2026-03-19T08:36:40.234Z",
    "period_end": "2026-03-19T08:36:40.234Z",
    "paid_at": "2026-03-19T08:36:40.234Z"
  },
  "payments": [
    {
      "hash": "text",
      "from": "text",
      "chain_id": 1,
      "block": 1,
      "amount": 1,
      "paid_by": "text",
      "paid_at": "2026-03-19T08:36:40.234Z",
      "linked_at": "2026-03-19T08:36:40.234Z",
      "coin": "BTC"
    }
  ],
  "merchant_id": "text",
  "installment_plan_id": "text",
  "pricing_mode": "crypto_base",
  "crypto_discount": 0,
  "extra_charge": 0,
  "is_remaining_balance_payment": false,
  "poap_minted": false,
  "offramp_status": "text",
  "offramp_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "date_created": "2026-03-19T08:36:40.234Z",
  "last_modified": "2026-03-19T08:36:40.234Z",
  "checkout_url": "text",
  "checkout_v2_url": "text",
  "conflict": true
}

• The 'reference' field can be used freely to create a reference for this payment request.

• The 'coins' attribute contains an array in the format [{'ticker': 'USDC', 'chain_id': 10}, {...}], where the ticker of each currency you want to offer as an option must be specified. All indicated currencies that do not have a configured address in the Business will be ignored. The API will respond with quotes for all tokens that have a configured address in the business.

• The 'notification_url' field is optional. It allows you to specify a different URL than the one configured in the business to receive notifications associated with this transaction.

Obtaining the dynamic QR

It is possible to obtain a QR code linked to a specific payment request. This QR code redirects to the checkout, linking the payment with the order created in the SimpleFi system or the payment network system.

Create Payment Request With Qr

post

Authorizations

OAuth2PasswordBearerExtended

OAuth2passwordRequired

Token URL:

Body

application/json

ars_amountany ofOptional

numberOptional

or

nullOptional

amountany ofOptional

numberOptional

or

nullOptional

currencyany ofOptional

string · enumOptionalPossible values:

or

nullOptional

itemsany ofOptional

or

nullOptional

memoany ofOptional

stringOptional

or

nullOptional

coinsany ofOptional

or

nullOptional

card_paymentany ofOptionalDefault: false

booleanOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

merchant_idany ofOptional

anyOptional

or

nullOptional

Responses

201

Successful Response

No content

422

Validation Error

application/json

post

/payment_requests/qr

HTTPcURLJavaScriptPython

POST /payment_requests/qr HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 309

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "card_payment": false,
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "notification_url": "text",
  "merchant_id": null
}

No content