Upgraded docs version is here ✨

Your documentation experience is getting an upgrade. Check it out now!

Go To Beta

Docs upgrade is here. Check it out!

Go To Beta
API ReferenceIntegrationsKnowledge Base

Entity & Metadata

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

Entity🔗

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.

Collection Entity🔗

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.

Notes🔗

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).

Example🔗

You can store the notes related to:

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