API Test Keys

Invoices Entity

The Invoices entity has the following parameters:

Is this page helpful?

Entity

1
{
2
"id": "inv_E7q0tqkxBRzdau",
3
"entity": "invoice",
4
"receipt": null,
5
"invoice_number": null,
6
"customer_id": "cust_E7q0trFqXgExmT",
7
"customer_details": {
8
"id": "cust_E7q0trFqXgExmT",
9
"name": "Gaurav Kumar",
10
"email": "gaurav.kumar@example.com",
11
"contact": "9876543210",
12
"gstin": null,
13
"billing_address": {
14
"id": "addr_E7q0ttqh4SGhAC",
15
"type": "billing_address",
16
"primary": true,
17
"line1": "Ground & 1st Floor, SJR Cyber Laskar",
18
"line2": "Hosur Road",
19
"zipcode": "560068",
20
"city": "Bengaluru",
21
"state": "Karnataka",
22
"country": "in"
23
},
24
"shipping_address": {
25
"id": "addr_E7q0ttKwVA1h2V",
26
"type": "shipping_address",
27
"primary": true,
28
"line1": "Ground & 1st Floor, SJR Cyber Laskar",
29
"line2": "Hosur Road",
30
"zipcode": "560068",
31
"city": "Bengaluru",
32
"state": "Karnataka",
33
"country": "in"
34
},
35
"customer_name": "Gaurav Kumar",
36
"customer_email": "gaurav.kumar@example.com",
37
"customer_contact": "9876543210"
38
},
39
"order_id": "order_E7q0tvRpC0WJwg",
40
"line_items": [
41
{
42
"id": "li_E7q0tuPNg84VbZ",
43
"item_id": null,
44
"ref_id": null,
45
"ref_type": null,
46
"name": "Master Cloud Computing in 30 Days",
47
"description": "Book by Ravena Ravenclaw",
48
"amount": 399,
49
"unit_amount": 399,
50
"gross_amount": 399,
51
"tax_amount": 0,
52
"taxable_amount": 399,
53
"net_amount": 399,
54
"currency": "INR",
55
"type": "invoice",
56
"tax_inclusive": false,
57
"hsn_code": null,
58
"sac_code": null,
59
"tax_rate": null,
60
"unit": null,
61
"quantity": 1,
62
"taxes": []
63
}
64
],
65
"payment_id": null,
66
"status": "issued",
67
"expire_by": null,
68
"issued_at": 1579765167,
69
"paid_at": null,
70
"cancelled_at": null,
71
"expired_at": null,
72
"sms_status": "pending",
73
"email_status": "pending",
74
"date": 1579765167,
75
"terms": null,
76
"partial_payment": false,
77
"gross_amount": 399,
78
"tax_amount": 0,
79
"taxable_amount": 399,
80
"amount": 399,
81
"amount_paid": 0,
82
"amount_due": 399,
83
"currency": "INR",
84
"description": null,
85
"notes": [],
86
"comment": null,
87
"short_url": "https://rzp.io/i/2wxV8Xs",
88
"view_less": true,
89
"billing_start": null,
90
"billing_end": null,
91
"type": "invoice",
92
"group_taxes_discounts": false,
93
"created_at": 1579765167
94
}
id
string

The unique identifier of the invoice.

entity
string

Indicates the type of entity. Here, it is invoice.

type
string

Here, it should be invoice.

invoice_number
string

Unique number you added for internal reference. The minimum character length is 1 and maximum is 40.

customer_id
string

The unique identifier of the customer. You can create customer_id using the

. Alternatively, you can pass the customer object described in the below fields.

customer_details
object

Details of the customer.

Show child parameters (6)

order_id
string

The unique identifier of the order associated with the invoice.

line_items
object

Details of the line item that is billed in the invoice. Maximum of 50 line items.

Show child parameters (8)

payment_id
string

Unique identifier of a payment made against this invoice.

status
string

The status of the invoice. Know more about

. Possible values:
  • draft
  • issued
  • partially_paid
  • paid
  • cancelled
  • expired
  • deleted

expire_by
integer

Timestamp, in Unix format, at which the invoice will expire.

issued_at
integer

Timestamp, in Unix format, at which the invoice was issued to the customer.

paid_at
integer

Timestamp, in Unix format, at which the payment was made.

cancelled_at
integer

Timestamp, in Unix format, at which the invoice was cancelled.

expired_at
integer

Timestamp, in Unix format, at which the invoice expired.

sms_status
string

The delivery status of the SMS notification for the invoice sent to the customer. Possible values:

  • pending
  • sent

email_status
string

The delivery status of the email notification for the invoice sent to the customer. Possible values:

  • pending
  • sent

partial_payment
boolean

Indicates whether the customer can make a partial payment on the invoice. Possible values:

  • true: The customer can make partial payments.
  • false (default): The customer cannot make partial payments.

amount
integer

Amount to be paid using the invoice. Must be in the smallest unit of the currency. For example, if the amount to be received from the customer is ₹300.00, pass the value as 30000. In the case of three decimal currencies, such as KWD, BHD and OMR, to refund a payment of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, to refund a payment of 295, pass the value as 295.

Watch Out!

As per payment guidelines, you should pass the last decimal number as 0 for three decimal currency payments. For example, if you want to refund a customer 99.991 KD for a transaction, you should pass the value for the amount parameter as 99990 and not 99991.

amount_paid
integer

Amount paid by the customer against the invoice.

amount_due
integer

The remaining amount to be paid by the customer for the issued invoice.

currency
string

The currency associated with the invoice. You must mandatorily pass this parameter if accepting international payments. If you have passed currency as a sub-parameter in the line_item object, you must ensure that the same currency is passed in both places. Know about the

Handy Tips

Razorpay has added support for zero decimal currencies, such as JPY, and three decimal currencies, such as KWD, BHD, and OMR, allowing businesses to accept international payments in these currencies. Know more about

(May 2024).

description
string

A brief description of the invoice. The maximum character length is 2048.

notes
object

Any custom notes added to the invoice. Maximum of 2048 characters.

short_url
string

The short URL that is generated. Share this link with customers to accept payments.

date
integer

Timestamp, in Unix format, that indicates the issue date of the invoice.

terms
string

Any terms to be included in the invoice. Maximum of 2048 characters.

comment
string

Any comments to be added in the invoice. Maximum of 2048 characters.

Invoices Entity

The Invoices entity has the following parameters:

Is this page helpful?

id
string

The unique identifier of the invoice.

entity
string

Indicates the type of entity. Here, it is invoice.

type
string

Here, it should be invoice.

invoice_number
string

Unique number you added for internal reference. The minimum character length is 1 and maximum is 40.

customer_id
string

The unique identifier of the customer. You can create customer_id using the

. Alternatively, you can pass the customer object described in the below fields.

customer_details
object

Details of the customer.

Show child parameters (6)

order_id
string

The unique identifier of the order associated with the invoice.

line_items
object

Details of the line item that is billed in the invoice. Maximum of 50 line items.

Show child parameters (8)

payment_id
string

Unique identifier of a payment made against this invoice.

status
string

The status of the invoice. Know more about

. Possible values:
  • draft
  • issued
  • partially_paid
  • paid
  • cancelled
  • expired
  • deleted

expire_by
integer

Timestamp, in Unix format, at which the invoice will expire.

issued_at
integer

Timestamp, in Unix format, at which the invoice was issued to the customer.

paid_at
integer

Timestamp, in Unix format, at which the payment was made.

cancelled_at
integer

Timestamp, in Unix format, at which the invoice was cancelled.

expired_at
integer

Timestamp, in Unix format, at which the invoice expired.

sms_status
string

The delivery status of the SMS notification for the invoice sent to the customer. Possible values:

  • pending
  • sent

email_status
string

The delivery status of the email notification for the invoice sent to the customer. Possible values:

  • pending
  • sent

partial_payment
boolean

Indicates whether the customer can make a partial payment on the invoice. Possible values:

  • true: The customer can make partial payments.
  • false (default): The customer cannot make partial payments.

amount
integer

Amount to be paid using the invoice. Must be in the smallest unit of the currency. For example, if the amount to be received from the customer is ₹300.00, pass the value as 30000. In the case of three decimal currencies, such as KWD, BHD and OMR, to refund a payment of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, to refund a payment of 295, pass the value as 295.

Watch Out!

As per payment guidelines, you should pass the last decimal number as 0 for three decimal currency payments. For example, if you want to refund a customer 99.991 KD for a transaction, you should pass the value for the amount parameter as 99990 and not 99991.

amount_paid
integer

Amount paid by the customer against the invoice.

amount_due
integer

The remaining amount to be paid by the customer for the issued invoice.

currency
string

The currency associated with the invoice. You must mandatorily pass this parameter if accepting international payments. If you have passed currency as a sub-parameter in the line_item object, you must ensure that the same currency is passed in both places. Know about the

Handy Tips

Razorpay has added support for zero decimal currencies, such as JPY, and three decimal currencies, such as KWD, BHD, and OMR, allowing businesses to accept international payments in these currencies. Know more about

(May 2024).

description
string

A brief description of the invoice. The maximum character length is 2048.

notes
object

Any custom notes added to the invoice. Maximum of 2048 characters.

short_url
string

The short URL that is generated. Share this link with customers to accept payments.

date
integer

Timestamp, in Unix format, that indicates the issue date of the invoice.

terms
string

Any terms to be included in the invoice. Maximum of 2048 characters.

comment
string

Any comments to be added in the invoice. Maximum of 2048 characters.

Entity

1
{
2
"id": "inv_E7q0tqkxBRzdau",
3
"entity": "invoice",
4
"receipt": null,
5
"invoice_number": null,
6
"customer_id": "cust_E7q0trFqXgExmT",
7
"customer_details": {
8
"id": "cust_E7q0trFqXgExmT",
9
"name": "Gaurav Kumar",
10
"email": "gaurav.kumar@example.com",
11
"contact": "9876543210",
12
"gstin": null,
13
"billing_address": {
14
"id": "addr_E7q0ttqh4SGhAC",
15
"type": "billing_address",
16
"primary": true,
17
"line1": "Ground & 1st Floor, SJR Cyber Laskar",
18
"line2": "Hosur Road",
19
"zipcode": "560068",
20
"city": "Bengaluru",
21
"state": "Karnataka",
22
"country": "in"
23
},
24
"shipping_address": {
25
"id": "addr_E7q0ttKwVA1h2V",
26
"type": "shipping_address",
27
"primary": true,
28
"line1": "Ground & 1st Floor, SJR Cyber Laskar",
29
"line2": "Hosur Road",
30
"zipcode": "560068",
31
"city": "Bengaluru",
32
"state": "Karnataka",
33
"country": "in"
34
},
35
"customer_name": "Gaurav Kumar",
36
"customer_email": "gaurav.kumar@example.com",
37
"customer_contact": "9876543210"
38
},
39
"order_id": "order_E7q0tvRpC0WJwg",
40
"line_items": [
41
{
42
"id": "li_E7q0tuPNg84VbZ",
43
"item_id": null,
44
"ref_id": null,
45
"ref_type": null,
46
"name": "Master Cloud Computing in 30 Days",
47
"description": "Book by Ravena Ravenclaw",
48
"amount": 399,
49
"unit_amount": 399,
50
"gross_amount": 399,
51
"tax_amount": 0,
52
"taxable_amount": 399,
53
"net_amount": 399,
54
"currency": "INR",
55
"type": "invoice",
56
"tax_inclusive": false,
57
"hsn_code": null,
58
"sac_code": null,
59
"tax_rate": null,
60
"unit": null,
61
"quantity": 1,
62
"taxes": []
63
}
64
],
65
"payment_id": null,
66
"status": "issued",
67
"expire_by": null,
68
"issued_at": 1579765167,
69
"paid_at": null,
70
"cancelled_at": null,
71
"expired_at": null,
72
"sms_status": "pending",
73
"email_status": "pending",
74
"date": 1579765167,
75
"terms": null,
76
"partial_payment": false,
77
"gross_amount": 399,
78
"tax_amount": 0,
79
"taxable_amount": 399,
80
"amount": 399,
81
"amount_paid": 0,
82
"amount_due": 399,
83
"currency": "INR",
84
"description": null,
85
"notes": [],
86
"comment": null,
87
"short_url": "https://rzp.io/i/2wxV8Xs",
88
"view_less": true,
89
"billing_start": null,
90
"billing_end": null,
91
"type": "invoice",
92
"group_taxes_discounts": false,
93
"created_at": 1579765167
94
}