Entity & Metadata

The entity structure and the metadata you can send along with the API request body.


Understand the API entity structure and how to send metadata using the notes object parameter in the API request body.

Every API response contains entities shared across different endpoints. There are some common attributes for every entity.

entity

string Indicates the type of the entity.

id

integer A unique identifier of the entity.

In an entity, the attributes can be used to make entity-specific API calls. For example, you can fetch the payment ID from an order.paid webhook and use it to initiate a refund for that payment.

Razorpay API also supports returning multiple entities for a single request. This response also has another entity collection. For the collection entity, the following parameters are common.

entity

string Indicates the type of the entity. For example, collection.

count

integer Indicates the number of items are returned. For example, 2.

items

array The list of entities.

The majority of the entities allow the notes object to store additional information and preserve data relevant to your integration. Razorpay does not use it for any operational purposes.

The notes object is a set of key-value pairs that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs, each 256 characters long (maximum).

You can store the notes related to:

  • Billing or shipping address of the initiated payment.
  • Reference ID generated for an order.