---
agentTools:
  projectIndex: https://kwikpaisa-neo-bank.readme.io/llms.txt
---

# Payout Initiate Request (UPI)

```curl
 curl  --request POST \
 --url {{Payout_UAT_Base_URL}}/payment/initiate-request \
 --header 'Content-Type: application/json' \
 --header 'x-client-id: <App ID>' \
 --header 'x-client-secret: <Secret Key>' \
 --header 'order-source: reset-api' \
--data-raw '{
   "kwikx_wallet_id": "<KwikXWalletID>",
    "debit_account_type": "kwikx_wallet",
    "transfer_type": "direct",
    "beneficiary_id": "null",
   "mobile": "9896989698",
    "email": "email@example.com",
    "address": null,
   "country_dialing_code": "91",
   "transfer_mode": "upi",
    "transfer_amount": "10.12",
    "upi_transfer": {
        "upi_owner_name": "beneficiary name",
        "upi_id": "upi-owner@upi",
        "is_validate": "false",
        "payment_for": "salary payment"
    },
    "payout_order_id": "654894598459"
}'
```
```json Success Response
{
  "code": "200",
  "status": "success",
  "type": "fund_transfer[direct]",
  "description": "api fund_transfer[direct] successfully performed",
  "available_balance_before": "9989.88",
  "transfer_amount": "10.12",
  "available_balance_after": "9979.76",
  "tranfer_rrn_number": "null",
  "unique_system_order_id": "payout_9acf1c79dff79df",
  "merchant_payout_order_id": "654894598459",
  "txn_status": "pending",
  "msg": "payout txn marked successfully, you will receive success and failed response from our side at your shared callback",
  "transfer_time": "21-06-2024 01:13:25pm"
}
```
```json Failed Response
{
    "error_code": "od_dup",
    "status": "failed",
    "error_description": "duplicate order id, kindly pass unique order id"
}
```

| Error Code | Message                                                   |
| :--------- | :-------------------------------------------------------- |
| 200        | API authentication successful!                            |
| 400        | Missing authentication parameters                         |
| 401        | Unauthorized - API authentication failed                  |
| 403        | Incoming IP address is not whitelisted                    |
| 405        | Unauthorized - Passed method not allowed                  |
| 409        | Request is not unique or correct                          |
| 422        | Missing required fields in body data or invalid JSON data |
| 500        | Server Error                                              |