---
title: Bank Account Penny Transfer
slug: investor-onboarding-io/bank-account-penny-transfer
description: Learn about the `/api/onboardings/execute` API endpoint, its required headers, and input parameters. Explore the nested objects in the `inputData` parameter, including the properties of the `data` object such as `searchParam`. Discover the expected output
docTags: 
createdAt: 2023-06-19T12:36:01.000Z
---

## Endpoint

**/api/onboardings/execute**

## Headers

| **Property**  | **Value**                                         |
| ------------- | ------------------------------------------------- |
| Content-type  | **application/json**                              |
| Authorization | …access token… (alphanumeric string of length 64) |

## Input

| **Property**   | **Data Type**                                        | **Example Values**                                     |
| -------------- | ---------------------------------------------------- | ------------------------------------------------------ |
| merchantId     | String (*Required*) alphanumeric string of length 24 | userId from investor login response                    |
| inputData      | Object (*Required*)                                  | Metadata along with actual payload to be executed upon |
| – service      | Enum String (*Required*)                             | “nonRoc”                                               |
| – type         | Enum String (*Required*)                             | “bankaccountverifications”                             |
| – task         | Enum String (*Required*)                             | “bankTransfer”                                         |
| – data         | Object (*Required*)                                  | payload                                                |
| —- searchParam | Object (*Required*)                                  | see below for details                                  |

### searchParam Object Details

```json
{
    "merchantId": ".......",
    "inputData": {
        "service": "nonRoc",
        "type": "bankaccountverifications",
        "task": "bankTransfer",
        "data": {
            "images": [],
            "toVerifyData": {},
            "searchParam": {
                "beneficiaryAccount": ".......",
                "beneficiaryIFSC": ".......",
                "beneficiaryName":"......",
                "beneficiaryMobile":"......"
            }
        }
    }
}
```

| **Property**       | **Data Type**                                                                               | **Example Values** |
| ------------------ | ------------------------------------------------------------------------------------------- | ------------------ |
| beneficiaryAccount | String (*Required*), string of min length of 9 and max length of 18 consisting of any digit | Account number     |
| beneficiaryIFSC    | String (*Required*), alphanumeric string of length 11                                       | IFSC code          |
| beneficiaryMobile  | String (*Optional*), valid 10-digit mobile number                                           | Mobile number      |
| beneficiaryName    | String (*Optional*), string of min length of 2 consisting of any character                  | Beneficiary Name   |

## Expected Output

```json
{
    "object": {
        "result": {
            "active": ".......",
            "nameMatch": ".......",
            "mobileMatch": ".......",
            "signzyReferenceId": ".......",
            "auditTrail": {
                "nature": ".......",
                "value": ".......",
                "timestamp": "......."
            }
        }
    }
}
```

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.


You can reach out to us at [help@signzy.com](#).
:::