APIs
Sub-processorsAbout PismoContact us
Start typing to search…

Transfer funds

post
https://sandbox.pismolabs.io/upi-gateway/v1/cards/transfer

United Payments Interface (UPI) funds transfer for RuPay, an Indian card network.

Before calling this endpoint, you can call List cards to get the account_reference_number. You should also call Validate card to make sure the card data for the transfer request is genuine.

This endpoint generates a Payment methods authorization created event and a Platform authorization created event.

Body Params

Request Body

number
required

Transaction amount

string
required

Transaction currency. ISO 4217 3-digit currency code. For example: INR (Indian rupee)

string
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.

string
required

Request datetime. ISO 8601 format.

string
required

Request transaction ID.

Must be unique as regards to transaction_type and account_reference_number.

This field guarantees the operation is idempotent, meaning, it can be applied multiple times, yet the outcome remains the same.

string
required

Transaction Merchant Category Code (MCC)

string
required

Merchant name

phone
object
required
string
enum
required

Transaction type:

  • C - Credit
  • D - Debit
  • R - Reversal
Allowed:
string
required
length between 12 and 12

UPI reference number

string

Transaction reference

string

Payee account number if available

Headers
string
required

Authorization token. Tokens can expire quickly, which can result in a 401 Unauthorized message.

string
required

Client consuming API.

Responses

Updated 14 days ago

Language
Credentials
Bearer
JWT
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 14 days ago