v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

UPI

Get funds transfer status

get/v1/transactions/inquiry/account-reference-number/{account_reference_number}/external-transaction-id/{external_transaction_id}

Path parameters

account_reference_numberstring required

Account reference number. Pismo creates this automatically when creating a card linked to RuPay on UPI

This number combines 10 BIN digits and the credit account number. If BIN is 6 digits, the remaining 4 digits are set to zero (0). If BIN is 8 digits, then the remaining 2 digits are set to zero. This is a NPCI standard. For example, if the account reference number = 1234560000987654321, the first six digits are the BIN, appended with 4 zeros and then the credit account number (`987654321``).

You can call List cards to get a card's account reference number.

external_transaction_idstring required

External transaction ID

Headers

Authorizationstring required

Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

user-agentstring required

Client consuming API.

Response

Response Body

external_transaction_datetimestring required

Request datetime. ISO 8601 format.

external_transaction_idstring required

Request ID code

status'PROCESSING' | 'ACCEPTED' | 'ERROR' | 'CANCELLED' required

Transaction status

transaction_type'C' | 'D' | 'R' | 'E' | 'F' required

Transaction type:

C - Credit
D - Debit
R - Reversal
E - Equated monthly installments (EMI)
F - Foreclose

upi_reference_numberstring required

UPI reference number

authorization_idnumber

Authorization ID

authorization_datetimestring datetime

When transfer was authorised. RFC 3339 format.

Example response

{
  "external_transaction_datetime": "2020-09-15T19:39:54.013Z",
  "external_transaction_id": "MGS584A1244F6BC4D50A3FABE6D93DF913C",
  "status": "PROCESSING",
  "transaction_type": "C",
  "upi_reference_number": "165238546812",
  "reason": {
    "code": "EUPI0001",
    "message": "An unexpected error happened"
  },
  "authorization_id": 2263052808
}