# What is merchant\_defined

**URL:** <https://community.rapyd.net/t/what-is-merchant-defined/219>\
**Category:** ⚙️ API\
**Created:** [May 4, 2021, 12:21pm UTC](https://community.rapyd.net/t/what-is-merchant-defined/219 "2021-05-04T12:21:46Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![onesoft](https://sea2.discourse-cdn.com/flex016/user_avatar/community.rapyd.net/onesoft/32/832_2.png) [@onesoft](https://community.rapyd.net/u/onesoft)\
**Post date:** [May 4, 2021, 12:21pm UTC](https://community.rapyd.net/t/what-is-merchant-defined/219/1 "2021-05-04T12:21:46Z")

</div>

Hi,

In [Checkout Page Object](https://docs.rapyd.net/build-with-rapyd/reference/checkout-page-object) merchant\_defined param are shown in like all examples - but it’s never explained.

```
metadata = new {
    merchant_defined = true
},

```

merchant\_currency\_only is explained is merchant\_defined the same

---

<div class="post-metadata">

**Author:** ![Legato](https://sea2.discourse-cdn.com/flex016/user_avatar/community.rapyd.net/legato/32/41_2.png) [@Legato](https://community.rapyd.net/u/Legato)\
**Post date:** [May 4, 2021, 2:47pm UTC](https://community.rapyd.net/t/what-is-merchant-defined/219/2 "2021-05-04T14:47:48Z")

</div>

Metadata objects are optional, and they exist in order to provide the merchant with additional information that they may want to add for their business practices. For example, a certain merchant may want to add the sales rep’s name that assisted with this payment while another merchant may want to add the number of days until the shipment will be processed. The documentation lists ‘merchant-defined’ in order to reiterate that this is optional information that the seller may want to provide in the API.

---

<div class="post-metadata">

**Author:** ![CharlesDorsett](https://sea2.discourse-cdn.com/flex016/user_avatar/community.rapyd.net/charlesdorsett/32/47_2.png) [@CharlesDorsett](https://community.rapyd.net/u/CharlesDorsett)\
**Post date:** [May 30, 2021, 2:12pm UTC](https://community.rapyd.net/t/what-is-merchant-defined/219/3 "2021-05-30T14:12:23Z")

</div>

Here’s a useful page from the API Reference:

[https://docs.rapyd.net/build-with-rapyd/reference/metadata-object](https://docs.rapyd.net/build-with-rapyd/reference/metadata-object)