---
page_title: Request Money
product: UPI TPAP SDK
platform: React Native
page_source: https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/request-money
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt
---


## Request Money



This operation will enable customers to request money from other UPI users


###   Process Parameters



## Request Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Value:
    - **Action**:
      - Description: Operation to be performed in the SDK.
      - Value: upiRequestMoney
      - Tags: String, Mandatory
    - **CustomerVpa**:
      - Description: Customer Vpa
      - Tags: String, Mandatory
    - **PayerVpa**:
      - Description: Payer Vpa. In case of UPI Number, you can get the VPA using valid VPA process
      - Tags: String, Mandatory
    - **PayerName**:
      - Description: Payer Name
      - Tags: String, Mandatory
    - **CollectRequestExpiryMinutes**:
      - Description: Duration after which collect request will become invalid. Default: 30
      - Value: eg : 15
      - Tags: String, Optional
    - **Amount**:
      - Description: Amount to be transfered. Numeric String with two decimals
      - Tags: String, Mandatory
    - **AccountReferenceId**:
      - Description: reference id for selected accounts
      - Tags: String, Mandatory
    - **Remarks**:
      - Description: Remarks of transaction
      - Tags: String, Mandatory
    - **UpiRequestId**:
      - Description: Request id for upi transaction
      - Tags: String, Mandatory
    - **Timestamp**:
      - Description: Time when request is created in milliseconds
      - Tags: String, Mandatory
    - **UpiNumber**:
      - Description: If request is to be sent to UPI Number
      - Tags: String, Optional
    - **MerchantKeyId**:
      - Description: Key ID to identify the public-private key pair used for signature generation
      - Tags: String, Mandatory
    - **Signature**:
      - Description: Signature generated for the signaturePayload
      - Value: <signature>
      - Tags: String, Mandatory
    - **SignaturePayload**:
      - Description: Signature payload is a stringified JSON of the details mentioned in the below table.
      - Value:
        - **Merchant_id**:
          - Description: Unique identifier associated with an account created by juspay. Ex: stock
          - Tags: String, Mandatory
        - **Customer_id**:
          - Description: Any unique reference associated with your customer.
          - Tags: String, Mandatory
        - **Timestamp**:
          - Description: Time when request is created in milliseconds.
          - Tags: String, Mandatory
        - **Amount**:
          - Description: Amount to be paid. Numeric String with two decimals
          - Value: eg: 2.00
          - Tags: String, Mandatory
        - **Currency**:
          - Value: eg: INR
          - Tags: String, Optional
        - **Customer_phone**:
          - Description: Mobile number
          - Tags: String, Optional
        - **Customer_email**:
          - Tags: String, Optional
      - Tags: String, Mandatory
  - Tags: JSON, Mandatory


## Response Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String
- **Payload**:
  - Description: Response Parameters
  - Value:
    - **Action**:
      - Description: Operation to be performed in the SDK.
      - Value: upiRequestMoney
      - Tags: String, Mandatory
    - **Status**:
      - Description: If upiRequestMoney call was success or failure
      - Value: SUCESS/FAILURE
      - Tags: String, Mandatory
    - **BankAccountUniqueId**:
      - Description: Unique Identifier for bank account across banks
      - Tags: String, Mandatory
    - **BankCode**:
      - Description: IIN Code for the bank
      - Tags: String, Mandatory
    - **CustomerMobileNumber**:
      - Description: Masked phone number of the customer
      - Value: <customer mobile number>
      - Tags: String, Mandatory
    - **CustomerVpa**:
      - Description: Customer Vpa
      - Tags: String, Mandatory
    - **MaskedAccountNumber**:
      - Description: Account Number with last few digits visible
      - Tags: String, Mandatory
    - **Amount**:
      - Description: Amount for which request is to be done. Numeric String with two decimals
      - Tags: String, Mandatory
    - **PayeeMcc**:
      - Description: Merchant Category Code of the payee merchant
      - Tags: String, Optional
    - **RefUrl**:
      - Tags: String, Optional
    - **GatewayResponseCode**:
      - Description: Response Code received from NPCI
      - Tags: String, Mandatory
    - **GatewayTransactionId**:
      - Description: upiRequestId as passed in request
      - Tags: String, Mandatory
    - **GatewayResponseMessage**:
      - Description: Response Message received from NPCI
      - Tags: String, Mandatory
    - **GatewayReferenceId**:
      - Description: Unique Transaction Number
      - Tags: String, Mandatory
    - **TransactionTimestamp**:
      - Description: Timestamp at which the request is made.
      - Tags: String, Mandatory
    - **OtherInfo**:
      - Description: As passed in request
      - Tags: String, Optional
  - Tags: JSON
- **Error**:
  - Description: Possible values :- true/false
  - Tags: Boolean
- **ErrorMessage**:
  - Description: Error Message
  - Tags: String
- **ErrorCode**:
  - Description: Error Code
  - Tags: String
- **Event**:
  - Description: Value: process_result
  - Tags: String





#### Code Snippets: -

#### Java Code Snippet:

```java
{"success":false,"message":"Failed to fetch snippet"}
```

#### Kotlin Code Snippet:

```kotlin
{"success":false,"message":"Failed to fetch snippet"}
```


## Sample Code Snippets:
### Request snippets:

#### Request Code Snippet:

```request
{"success":false,"message":"Failed to fetch snippet"}
```

### Response snippets:

#### Response:
```plaintext
{"success":false,"message":"Failed to fetch snippet"}
```



---

## Complete Code Reference

The following code files are referenced in the steps above:

### InappHeadless1.txt

```
{"success":false,"message":"Failed to fetch snippet"}
```


---

## See Also

- [Send Money](https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/send-money)
- [Pay to UPI Number](https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/pay-to-upi-number)