Skip to main content
POST
/
ppi
/
wallet
Create Wallet
curl --request POST \
  --url https://api.cashfree.com/ppi/wallet \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "user_id": "7234567890123456789",
  "program_id": "9876543210987654321"
}'
{
  "user_id": "7234567890123456789",
  "program_id": "9876543210987654321",
  "wallet_id": "5646543210987654321",
  "wallet_name": "Cashback Wallet",
  "sub_wallets": [
    {
      "id": "35246543210987654321",
      "name": "Meal Wallet"
    },
    {
      "id": "54252453468535350356",
      "name": "Fuel Wallet"
    }
  ]
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree.

​
x-client-secret
string
header
required

The secret key associated with your client ID.

Body

application/json
​
user_id
string
required

Unique identifier for the user.

Required string length: 1 - 50
Example:

"1234567890123456789"

​
program_id
string
required

Unique identifier for the program.

Required string length: 1 - 50
Example:

"9876543210987654321"

Response

Wallet created successfully.

​
user_id
string

Unique identifier for the user.

Example:

"1234567890123456789"

​
program_id
string

Unique identifier for the program.

Example:

"9876543210987654321"

​
wallet_id
string

Unique wallet identifier.

Example:

"8765432109876543210"

​
wallet_name
string

Name of the wallet.

Example:

"Cashback Wallet"

​
sub_wallets
object[]

List of sub-wallets created for this wallet.

⌘I