> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Phone Number and Beneficiary Name

> Send Cashfree Pay-to-Phone payouts using only the beneficiary's phone number and name, removing the need to collect bank account numbers or IFSC codes.

## What is PayToPhone?

PayToPhone is a capability that empowers merchants to directly process payouts to end beneficiaries using their phone numbers. This will not only reduce the dependency on end-users to share details (account number/IFSC/VPA), but it will also make their onboarding/refund/disbursal journeys shorter and less complex leading to a better conversion rates.

## How does this capability work?

You need to collect the beneficiary's name and phone number to process the payouts. Once you initiate a payout through Cashfree using this feature, we analyse the entered name matches with the record in the respective bank's database. This helps us automatically block payouts initiated to incorrect beneficiaries.

The funds are transferred to the latest modified VPA linked to the mobile number. The latest modification could mean addition of a new VPA or details changed of the existing VPA linked to the mobile number.

## Transfer APIs

Use our APIs to initiate payouts to end beneficiaries with only their phone number and name.

```curl Direct Transfer - API Request theme={"dark"}
curl --location 'https://payout-api.cashfree.com/payout/v1.2/directTransfer' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": "1.00",
    "transferId": "Test123d11q6",
    "transferMode": "phone",
    "remarks": "test",
    "beneDetails" : {
        "name": "Ranjiths",
        "email": "beneficiary@example.com",
        "phone": "9415258595",
        "address1": "any_dummy_value"
    }
}'
```

```curl Standard Transfer - API Request theme={"dark"}
curl --location 'https://payout-api.cashfree.com/payout/v1/requestTransfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [TOKEN]' \
--data '{
  "beneId": "B_Test123dedd11q6_0R5W2K",
  "amount": "1.2",
  "transferId": "test_sdssdssbsunilt34",
  "transferMode": "phone"
}
'
```

Once you trigger the [Standard Transfer API](/docs/api-reference/payouts/v1/standard-transfer-sync#standard-transfer-sync), we immediately attempt to transfer the amount to the beneficiary account wherein the bank's reference number is returned in the API response. The median time for the response is 2 to 5 seconds.

### Response codes

View the 200 related response codes below:

```json 200 - Transfer completed successfully theme={"dark"}
{
	"status": "SUCCESS",
	"subCode": "200",
	"message": "Transfer completed successfully",
	"data": {
		"referenceId": "10023",
		"utr": "P16111765023806",
		"acknowledged": 1
	}
}
```

View the 201 response code below:

```json 201 - Pending transfer theme={"dark"}
{
	"status": "PENDING",
	"subCode": "201",
	"message": "Transfer request pending at the bank",
	"data": {
		"referenceId": "1387592652",
		"utr": "",
		"acknowledged": 0
	}
}
```

View the 4XX response codes below:

```json Invalid phone number or number not linked to VPA theme={"dark"}
{
	"status": "ERROR",
	"subCode": "400",
	"message": "Phone number invalid or not linked to a VPA."
}
```

```json Invalid characters in remarks theme={"dark"}
{
	"status": "ERROR",
	"subCode": "422",
	"message": "Remarks can have only numbers, alphabets and whitespaces."
}
```

```json Beneficiary not found theme={"dark"}
{
	"status": "ERROR",
	"subCode": "404",
	"message": "Beneficiary does not exist"
}
```

## Check status APIs

Use our APIs to initiate payouts to end beneficiaries with only their phone number and name.

### Response codes

View the 200 related response codes below:

```json 200 - Transfer completed successfully theme={"dark"}
{
	"status": "SUCCESS",
	"subCode": "200",
	"message": "Transfer completed successfully",
	"data": {
		"referenceId": "10023",
		"utr": "P16111765023806",
		"acknowledged": 1
	}
}
```

### Name match verification

Name match verification is a critical component of ensuring the correct beneficiary receives the transferred amount. There are five possible outcomes of this name match verification:

#### Direct match

| Name 1              | Name 2              | Score  |
| :------------------ | :------------------ | :----- |
| Rohan Mathew Thomas | Rohan Mathew Thomas | 100.00 |

Since the above names are exactly the same, we get a perfect score. In this case, we initiate the payouts to the respective beneficiary.

#### Good partial match

| Name 1              | Name 2        | Score |
| :------------------ | :------------ | :---- |
| Rohan Mathew Thomas | Roshan Thomas | 85.00 |

In the above example, *Mathew* is missing but the rest of the names match perfectly. We initiate the payouts to the respective beneficiary since we are most definitely sure that it is the same person.

#### Moderate partial match

| Name 1              | Name 2        | Score |
| :------------------ | :------------ | :---- |
| Rohan Mathew Thomas | Roshan Thomas | 61.00 |

In the above example, *Thomas* and a partial *han* is present in both the names. Even though these similarities help increase the score, we do not initiate the payouts since the names match only moderately.

#### Poor partial match

| Name 1              | Name 2         | Score |
| :------------------ | :------------- | :---- |
| Rohan Mathew Thomas | Rohan Mathew K | 55.00 |

In the above example, although the first and the middle name seem to be the same, the initial *K* could mean a different person. We do not initiate the payouts since it is a poor partial match of the names.

#### No match

| Name 1              | Name 2 | Score |
| :------------------ | :----- | :---- |
| Rohan Mathew Thomas | Rajeev | 14.00 |

It is obvious from the above example that we do not initiate payouts since they both are different names.

<div class="hidden" data-table-of-contents="bottom">
  <p class="mt-4 font-medium flex items-center gap-2 related-docs-heading">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="w-4 h-4">
      <path d="M3 4h7a2 2 0 0 1 2 2v13a2 2 0 0 0-2-2H3z" />

      <path d="M21 4h-7a2 2 0 0 0-2 2v13a2 2 0 0 1 2-2h7z" />
    </svg>

    <span>Related topics</span>
  </p>

  <ul>
    <li><a href="/docs/api-reference/payouts/v1/standard-transfer-sync#standard-transfer-sync">Standard Transfer API</a></li>
    <li><a href="/docs/payouts/payouts/beneficiaries-management">Beneficiary Management</a></li>
    <li><a href="/docs/payouts/payouts/general-faqs">Payouts FAQs</a></li>
  </ul>
</div>
