Create a Fund Account of Type Wallet

POST /v1/fund-accounts/

Use this endpoint to create a Fund Account of the type wallet. A new Fund Account is created if any combination of the following details is unique: contact_id, wallet.phone.number, wallet.phone.country_code, and wallet.email.

• If all the above details match the details of an existing Fund Account, the API returns details of the existing Fund Account.
• You cannot edit the details of a Fund Account.

Request

Curl

curl -u : \
-X POST https://api.razorpay.com/v1/fund_accounts \
-H "Content-Type: application/json" \
-d '{
  "contact_id": "cont_00000000000001",
  "account_type": "wallet",
  "wallet": {
    "provider": "amazonpay",
    "phone": "[phone]",
    "email": "[e-mail]",
    "name": "Gaurav Kumar"
  }
}'

Response

Success

{
  "id": "fa_00000000000001",
  "entity": "fund_account",
  "contact_id": "cont_00000000000001",
  "account_type": "wallet",
  "wallet": {
    "provider": "amazonpay",
    "phone": "[phone]",
    "email": "[e-mail]",
    "name": "Gaurav Kumar"
  },
  "active": true,
  "batch_id": null,
  "created_at": 1543650891
}

Parameters

contact_id mandatory : string The unique identifier linked to a contact. For example, cont_00000000000001.

account_type mandatory : string The account type you want to link to the contact ID. Here, it is wallet.

wallet mandatory : object The contact’s wallet details.

provider mandatory : string The wallet provider. Here, it is amazonpay.

phone mandatory : string Beneficiary phone details. 10 digit beneficiary phone number with the country code. For example, [phone] .

email optional : string Beneficiary email address. For example, [e-mail].

name optional : string Wallet holder’s name. Name must be between 4 - 120 characters. This field is case-sensitive. Name cannot end with a special character, except .. Supported characters: a-z, A-Z, 0-9, space, ’ , - , _ , / , ( , ) and , .. For example, Gaurav Kumar.

Parameters

id : string The unique identifier linked to the fund account. For example, fa_00000000000001.

entity : string Here it will be fund_account.

contact_id : string The unique identifier linked to the contact. For example, cont_00000000000001.

account_type : string The fund account type created. Here it is wallet.

wallet : object The contact’s wallet details.

provider : string The wallet provider. Here, it is amazonpay.

phone : string 10 digit beneficiary phone number with the country code. For example, [phone] .

email : string Beneficiary email address. For example, [e-mail].

name : string Wallet holder’s name. For example, Gaurav Kumar.

active : boolean Possible values:

• true: active
• false: inactive

batch_id : string This parameter is populated if the fund account was created as part of a bulk upload. For example, batch_00000000000001.

created_at : integer Timestamp, in Unix, when the fund account was created. For example, 1545320320.