Creación de solicitud de pago

Las solicitudes de pago se crean a partir de un monto en pesos, y contienen la información de la cotización de la orden en cada noneda disponible para realizar el pago. Para iniciar un pago, es necesario primero que se cree la solicitud de pago.

La ruta para crearlos recibe un monto en pesos y las monedas aceptadas, y el backend calcula la cotización en cada moneda y la guarda en la base de datos. El sistema de SimpleFi escucha las blockchains de todas las monedas aceptadas y actualiza las solicitudes de pago cuando se encuentran los pagos correspondientes.

Para crear una solicitud de pago:

Create Payment Request

POST/payment_requests

Authorization

OAuth2PasswordBearerExtended

Body

application/json

ars_amountArs Amount

numbernull

amountAmount

numbernull

currencyany of

Fiatnull

itemsItems

array of CreateItemModelnull

card_paymentCard Payment

booleannull

reference*Reference

memoMemo

stringnull

coinsCoins

array of NewTransactionModelnull

notification_urlNotification Url

stringnull

merchant_idMerchant Id

anynull

Response

201422

Successful Response

Body

application/json

id*Id

order_id*Order Id

ars_amount*Ars Amount

ars_paid*Ars Paid

amount*Amount

amount_paid*Amount Paid

currency*Fiat

ARSUSD

itemsItems

array of ItemModelnull

usd_amount*Usd Amount

reference*Reference

memoMemo

stringnull

notification_urlNotification Url

stringnull

status*PaymentRequestStatus

pendingapprovedcanceledexpiredrefunded

status_detail*TransactionStatus

not_paidcorrectunderpaidoverpaid

expiration_time*Expiration Time

delivered*Delivered

transactions*Transactions

card_paymentany of

CardPaymentModelnull

payments*Payments

merchant_id*Merchant Id

date_created*Date Created

last_modified*Last Modified

checkout_url*Checkout Url

conflict*Conflict

Request

JavaScriptCurlPython

const response = await fetch('/payment_requests', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201422

{
  "id": "text",
  "order_id": 0,
  "ars_amount": 0,
  "ars_paid": 0,
  "amount": 0,
  "amount_paid": 0,
  "currency": "ARS",
  "items": [
    {
      "id": "text",
      "quantity": 0,
      "name": "text",
      "price": 0,
      "currency": "ARS"
    }
  ],
  "usd_amount": 0,
  "memo": "text",
  "notification_url": "text",
  "status": "pending",
  "status_detail": "not_paid",
  "expiration_time": "2024-12-26T17:43:28.277Z",
  "delivered": false,
  "transactions": [
    {
      "id": "text",
      "price_details": {
        "currency": "ARS",
        "currency_amount": 0,
        "currency_final_amount": 0,
        "base_amount": 0,
        "final_amount": 0,
        "paid_amount": 0,
        "discount_rate": 0,
        "rate": 0
      },
      "coin": "BCH",
      "chain_id": 0,
      "address": "text",
      "status": "not_paid",
      "payment_request_id": "text",
      "memo": "text",
      "payments": [
        {
          "hash": "text",
          "block": 0,
          "amount": 0,
          "paid_by": "text",
          "paid_at": "2024-12-26T17:43:28.277Z",
          "linked_at": "2024-12-26T17:43:28.277Z"
        }
      ],
      "date_created": "2024-12-26T17:43:28.277Z",
      "last_modified": "2024-12-26T17:43:28.277Z"
    }
  ],
  "card_payment": {
    "provider": "stripe",
    "session_url": "text",
    "price_details": {
      "currency": "ARS",
      "amount": 0,
      "final_amount": 0,
      "usd_final_amount": 0,
      "paid_amount": 0,
      "discount_rate": 0,
      "rate": 0
    },
    "status": "not_paid",
    "date_created": "2024-12-26T17:43:28.277Z",
    "last_modified": "2024-12-26T17:43:28.277Z"
  },
  "payments": [
    {
      "hash": "text",
      "block": 0,
      "amount": 0,
      "paid_by": "text",
      "paid_at": "2024-12-26T17:43:28.277Z",
      "linked_at": "2024-12-26T17:43:28.277Z",
      "coin": "BCH"
    }
  ],
  "merchant_id": "text",
  "date_created": "2024-12-26T17:43:28.277Z",
  "last_modified": "2024-12-26T17:43:28.277Z",
  "checkout_url": "text",
  "conflict": false
}

• El campo 'reference' puede ser utilizado libremente para crear una referencia a este solicitud de pago.

• En el atributo 'coins' contiene un array con formato [{'ticker': 'USDC', 'chain_id': 10}, {..}]donde se debe indicar el ticker de cada moneda que se quiere ofrecer como opción. Todas las monedas indicadas que no tengan una dirección configurada en el Negocio, se ignorarán. La API responderá con cotizaciones para todos los tokens que tengan dirección configurada en el negocio.

• El campo 'notification_url' es opcional. Permite indicar una URL distinta a la configurada en el negocio para recibir las notificaciones asociadas a esta transacción.

Mirá los tokens disponibles.

Obtención de QR de único uso

Es posible obtener un QR vinculado a una Solicitud de pago específica. Este QR redirige al checkout vinculando el pago con la orden creada por backoffice en el sistema de SimpleFi o el sistema de la red de pagos.

Create Payment Request With Qr

POST/payment_requests/qr

Authorization

OAuth2PasswordBearerExtended

Body

application/json

ars_amountArs Amount

numbernull

amountAmount

numbernull

currencyany of

Fiatnull

itemsItems

array of CreateItemModelnull

card_paymentCard Payment

booleannull

reference*Reference

memoMemo

stringnull

coinsCoins

array of NewTransactionModelnull

notification_urlNotification Url

stringnull

merchant_idMerchant Id

anynull

Response

201422

Successful Response

Request

JavaScriptCurlPython

const response = await fetch('/payment_requests/qr', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

422

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}