---
description: Api details for smart send
---

# Smart Send API

{% hint style="warning" %}
#### Note: These API's are now deprecated. Please use Smart Send v2 API's for new integrations.
{% endhint %}

{% tabs %}
{% tab title="Production" %}
[https://payout.payumoney.com/payout/smartPay](https://payout.payumoney.com/payout/smartPay)
{% endtab %}

{% tab title="Testing" %}
&#x20;[https://test.payumoney.com/payout/smartPay](https://www.payumoney.com/payout/smartPay)
{% endtab %}
{% endtabs %}

## **Request Header Params**

| **Key**          | **Description**                                   | **Data type**  | **Mandatory**  | **possible Values**     |
| ---------------- | ------------------------------------------------- | -------------- | -------------- | ----------------------- |
| Authorization    | Access token generated earlier.                   | String         | Yes            |  Bearer {access\_token} |
| payoutMerchantId | This is the merchant id provided while onboarding | String         | Yes            |                         |

{% hint style="danger" %}
**payoutMerchantId is different from payumoney merchant id, please check payouts dashboard or call customer support if you don’t know your payoutsMerchantID**
{% endhint %}

## **Request Params**

| **Key**       | **Description**                                                                                                                                                          | **Data type**  | **Mandatory**  | **possible Values**  |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- | -------------- | -------------------- |
| merchantRefId | Unique reference id generated at merchant side to distinguish between multiple transfers. Same value will be used by merchant in status check of transfer and cancel it. | String         | Yes            |                      |
| amount        | The Amount that the merchant wants to send the customer                                                                                                                  | Double(20,2)   | Yes            |                      |
| custEmail     | Email of the customer to do otp verification. One of the email or mobile is mandatory                                                                                    | String         | Optional       |                      |
| custMobile    | Mobile of the customer to do otp verification. One of the email or mobile is mandatory                                                                                   | String         | Optional       |                      |
| custName      | Name of the customer who you are sending fund.                                                                                                                           | String         | No             |                      |
| description   | Description of the transfer                                                                                                                                              | String         | Yes            |                      |

## **Example**

Content-Type : application/json

Method : POST

{% hint style="info" %}
Do not forget to use the ‘application/json’ as the content type when you call our api
{% endhint %}

**Sample Request Body:**

```
{
 "amount":1.00,
 "merchantRefId":"test1111",
 "custEmail" : "test@gmail.com",
 "custName": "test",
 "custMobile":"9999999999",
 "description" : "smart pay test1"
}
```

**Response Body :**

{% tabs %}
{% tab title="Success" %}
```
{
  "status": 0,
  "msg": "Success",
  "code": null,
  "data": {
          "link": "https://test.payumoney.com/smartPay?id=Dl7jbRuKacFXq74Smt8DhktBTbkj5eWI%2BuB5gUBMRH9mz8cBKYBITJ9hANGG1mEQ",
          "linkId": "Dl7jbRuKacFXq74Smt8DhktBTbkj5eWI+uB5gUBMRH9mz8cBKYBITJ9hANGG1mEQ",
          }
}
```
{% endtab %}

{% tab title="Failure" %}
```
{
  "status": 1,
   "msg": "Fail",
   "code": null,
   "data": [
             {
               "code": 1108,
               "message": "custMobile or custEmail is required"
             }
           ]
 }
```
{% endtab %}
{% endtabs %}



## &#x20;**Response Params**

| **Key**      | **Description**                                                                         |
| ------------ | --------------------------------------------------------------------------------------- |
| data.link    | link generated for the customer where he or she can fill the details                    |
| data.linkId  | Id generated for link. Same will be used to check if details are filled in link or not. |
