Querying the status of a payment

To check the status of a payment, a request must be made with the payment ID received at the time of creation.

Get Payment Request

GET/payment_requests/{payment_request_id}

Authorization

OAuth2PasswordBearerExtended

Path parameters

payment_request_id*Payment Request Id

Response

200422

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/{payment_request_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "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-26T22:51:29.220Z",
  "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-26T22:51:29.220Z",
          "linked_at": "2024-12-26T22:51:29.220Z"
        }
      ],
      "date_created": "2024-12-26T22:51:29.220Z",
      "last_modified": "2024-12-26T22:51:29.220Z"
    }
  ],
  "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-26T22:51:29.220Z",
    "last_modified": "2024-12-26T22:51:29.220Z"
  },
  "payments": [
    {
      "hash": "text",
      "block": 0,
      "amount": 0,
      "paid_by": "text",
      "paid_at": "2024-12-26T22:51:29.220Z",
      "linked_at": "2024-12-26T22:51:29.220Z",
      "coin": "BCH"
    }
  ],
  "merchant_id": "text",
  "date_created": "2024-12-26T22:51:29.220Z",
  "last_modified": "2024-12-26T22:51:29.220Z",
  "checkout_url": "text",
  "conflict": false
}

Payment Statuses (status):

• Pending (pending): The payment is awaiting processing.

• Completed (approved): The payment has been successfully completed.

• Refunded (refunded): The payment has been refunded.

• Canceled (canceled): The payment has been canceled.

• Expired (expired): The payment has exceeded the time limit for completion.

Payment Status Details (status_detail):

• Exact Payment (correct): The payment was received for the exact amount of the transaction.

• Insufficient (underpaid): The payment received is less than the expected amount.

• Exceeded (overpaid): The payment received is greater than the expected amount.

• No Payments (not_paid): No payment has been received for this transaction.