API Test Keys

Update a QR Code

PATCH

/v1/payments/qr_codes/:id/

Click to copy

Use this endpoint to update a QR Code.

Is this page helpful?

Curl

1curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
2-X PATCH https://api.razorpay.com/v1/payments/qr_codes/qr_HMsVL8HOpbMcjU/
3-d '{
4	"notes": {
5		"key1": "value1",
6		"key2": "value2"
7	}
8}'

Success

Failure

1{
2  "id":"qr_HMsVL8HOpbMcjU",
3  "entity":"qr_code",
4  "created_at":1623660301,
5  "name":"Store Front Display",
6  "usage":"single_use",
7  "type":"upi_qr",
8  "image_url":"https://rzp.io/i/BWcUVrLp",
9  "payment_amount":300,
10  "status":"closed",
11  "description":"For Store 1",
12  "fixed_amount":true,
13  "payments_amount_received":0,
14  "payments_count_received":0,
15  "notes":{
16    "key1": "value1",
17    "key2": "value2"
18  },
19  "customer_id":"cust_HKsR5se84c5LTO",
20  "close_by":1681615838,
21}

Path Parameters

id

string

The unique identifier of the QR Code. For example, qr_HMsVL8HOpbMcjU.

Request Parameters

notes

json object

Contains user-defined fields and is stored for reference purposes. Know more about

notes

Response Parameters

id

string

The unique identifier of the QR Code. For example, qr_HMsVL8HOpbMcjU.

entity

string

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

created_at

integer

Unix timestamp at which the QR Code is created.

name

string

Label entered to identify the QR Code. For example, Store Front Display.

usage

string

Indicates if the QR Code should be allowed to accept single payment or multiple payments. Possible values:

single_use: QR Code will accept only one payment and then close automatically.
multiple_use (default): QR Code will accept multiple payments.

type

string

The type of the QR Code. Possible value is upi_qr, which creates a QR Code that accepts only UPI payments.

Feature Request

This is an on-demand feature. Please raise a request with our

Support team

to get this feature activated on your account.

image_url

string

The URL of the QR Code. For example, http://rzp.io/l6MS. Click the link to download the code.

payment_amount

integer

The amount allowed for a transaction. If this is specified, then any transaction of an amount less than or more than this value is not allowed. For example, if this amount is set as 500000, the customer cannot pay an amount less than or more than ₹5000.

status

string

Indicates the status of the QR Code. Possible values:

active: Indicates that the QR Code has been created and is ready to accept payments.
closed: Indicates that the QR Code has been closed.

description

string

A brief description about the QR Code.

fixed_amount

boolean

Indicates if the QR Code should accept payments of specific amounts or any amount. Possible values:

true: QR Code accepts only a specific amount.
false (default): QR code accepts any amount.

payments_amount_received

integer

The total amount received on the QR Code. Only captured payments are considered.

payments_count_received

integer

The total number of payments received on the QR Code. All captured payments are considered.

notes

object

Key-value pair that can be used to store additional information about the QR Code. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

customer_id

string

The unique identifier of the customer the QR Code is linked with. Know more about the

Customers API

close_by

integer

Unix timestamp at which the QR Code is scheduled to be automatically closed. The time must be at least 15 minutes after the current time. The date range can be set to 2147483647 in Unix timestamp format (equivalent to Tuesday, January 19, 2038 8:44:07 AM GMT+05:30).

Errors

The API {key/secret} provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard.

Solution

Update a QR Code

PATCH

/v1/payments/qr_codes/:id/

Click to copy

Use this endpoint to update a QR Code.

Is this page helpful?

Path Parameters

id

string

The unique identifier of the QR Code. For example, qr_HMsVL8HOpbMcjU.

Request Parameters

notes

json object

Contains user-defined fields and is stored for reference purposes. Know more about

notes

Response Parameters

id

string

The unique identifier of the QR Code. For example, qr_HMsVL8HOpbMcjU.

entity

string

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

created_at

integer

Unix timestamp at which the QR Code is created.

name

string

Label entered to identify the QR Code. For example, Store Front Display.

usage

string

Indicates if the QR Code should be allowed to accept single payment or multiple payments. Possible values:

single_use: QR Code will accept only one payment and then close automatically.
multiple_use (default): QR Code will accept multiple payments.

type

string

The type of the QR Code. Possible value is upi_qr, which creates a QR Code that accepts only UPI payments.

Feature Request

This is an on-demand feature. Please raise a request with our

Support team

to get this feature activated on your account.

image_url

string

The URL of the QR Code. For example, http://rzp.io/l6MS. Click the link to download the code.

payment_amount

integer

status

string

Indicates the status of the QR Code. Possible values:

active: Indicates that the QR Code has been created and is ready to accept payments.
closed: Indicates that the QR Code has been closed.

description

string

A brief description about the QR Code.

fixed_amount

boolean

Indicates if the QR Code should accept payments of specific amounts or any amount. Possible values:

true: QR Code accepts only a specific amount.
false (default): QR code accepts any amount.

payments_amount_received

integer

The total amount received on the QR Code. Only captured payments are considered.

payments_count_received

integer

The total number of payments received on the QR Code. All captured payments are considered.

notes

object

Key-value pair that can be used to store additional information about the QR Code. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

customer_id

string

The unique identifier of the customer the QR Code is linked with. Know more about the

Customers API

close_by

integer

Errors

The API {key/secret} provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard.

Solution

Curl

1curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
2-X PATCH https://api.razorpay.com/v1/payments/qr_codes/qr_HMsVL8HOpbMcjU/
3-d '{
4	"notes": {
5		"key1": "value1",
6		"key2": "value2"
7	}
8}'

Success

Failure

1{
2  "id":"qr_HMsVL8HOpbMcjU",
3  "entity":"qr_code",
4  "created_at":1623660301,
5  "name":"Store Front Display",
6  "usage":"single_use",
7  "type":"upi_qr",
8  "image_url":"https://rzp.io/i/BWcUVrLp",
9  "payment_amount":300,
10  "status":"closed",
11  "description":"For Store 1",
12  "fixed_amount":true,
13  "payments_amount_received":0,
14  "payments_count_received":0,
15  "notes":{
16    "key1": "value1",
17    "key2": "value2"
18  },
19  "customer_id":"cust_HKsR5se84c5LTO",
20  "close_by":1681615838,
21}