Can you show that in the screenshot with that red highlighter box?

Reports -> Reimbursements

Go to Pending Flexible Benefits Requests.

Keep it consistent. Steps should be written exactly how we call it out in the TW Guidelines. Don't use 'scroll down to find' kind of terminologies.

Endpoint missing

The following endpoint submits the OTP...?

Lead-in sentence to maintain consistency.

in

17,960-5,000=12,960

5,000

Remove. Just saying an error message is displayed is enough.

Remove

hyperlink or provide support email address

Image not visible.

Image below this not visible on beta

You can run payroll on XPayroll in 3 different ways: 1. Custom Salary 2. Stop Salary 3. Skip Salary

by clicking Checkout.

is displayed to the customers

Please use 'Select/deselect the checkbox'

Click Next to save...? Conclusion step missing.

from the Platform drop-down list.

Click Edit in the Analytics Settings section.

Remove

Here as well.

enable

Why the question mark?

Mention click Edit under Checkout Settings too... (under any circumstance where viewer is unable to see image loading... Edit link is also under Analytics Settings). Hence. to be more clear...

remove

act as

Human Resource Management System

remove. Keep it consistent with how we have listed this in the previous bullet point

Link

remove

you can interact with our email support

Hyperlink this to the XPayroll Overview page

must be retrieved.

Change fetched to retrieved at all places.

This need not be a bullet point. Since there is no list actually...

to be

to be

You can set up transfer of funds

Full stop to be removed from here. To maintain consistency

See if it is possible to show the screenshot of Add Key (in the attached screenshot itself)

if we have noticed

c

Not visible in the screenshot... Only REST API one is visible.

Redundant. We can skip this part as anyway, this is about manual review

This should be 'Handy Tips' in my opinion.

Instead of hyperlinking the word 'Approval'... Can you add 'Contact Support' and link that instead?

For ex: Requires approval. Contact Support.

You can view the EMIs enabled for your Razorpay account

Remove. Redundant. Already mentioned in 1st paragraph.

This payment option encourages your customers to make big value purchases without worrying about paying the full amount upfront.

Remove helps you since the action is not really on the merchant

remove

remove article

typo. Delete

You can customise the widget based on the following themes and colours

To display

To display limited offers on the widget, enter the offer_id of the offers

click Manage.

to edit the settings is redundant since we have already indicated to the user that he is customising the widget.

Once you preview the widget, disable the Test mode and click Save Changes.

Reason: only user action is required in task steps.

after

This could be 'Handy Tips' text right? Content doesn't seem like a warning one...

Remove .

Hyperlink this to the support page/form

PCI-compliant

hyperlink this

Heading missing for the code below. Always have a 'Sample Code' heading for all API codes

Also, looks like there is a formatting issue in the code here...

Here too, remove the article

Hyperlink only Payouts

This looks odd. Remove the 'A'

replace with may, both instances in this sentence.

or

you can skip a few steps when certain conditions are fulfilled or can be ignored.

IMP: typo - "skip few a steps" instead of "skip a few steps"

Invoices. Used in noun form always.

with

Can we use a screenshot of the amount details section please? We have used this screenshot before. Why repeat...

Dashboard

Explain what outstanding and overdue is here with a callout.

Highlight the button in the image with the red rectangle.

Can this be given in some other form? Instead of a table...

Suggested: 1. Login to RazorpayX Dashboard 2. Navigate to Vendor Payments 3. Click Vendor tab

You will see a list of vendors with details such as vendor name, email. outstanding, overdue and last invoice on.

Task. Take it to the next line. Let the first step be login to razorpayx dashboard

"pay...... to be paid" doesn't seem right.

Suggested:

View or pay your vendor bills, in parts or full directly from the Dashboard.

Add link to API Error codes from document sufficiently.

Link to main doc.

Change format to table.

is supported only for plain cards. Not available for tokenised cards.

Only visa is available. Mastercard is under development.

Add the tokenisation related change here.

Give link to Razorpay's Token HQ, a brief introduction to what it is.

Change heading

Swaroop:

1. Heading to change to Payouts to Cards
2. Document structure should be same as what Swaroop shared (merchant facing doc)
3. 3 ways in which merchant can make payouts to cards - intro section not covered.

Isn't this a dynamic invoice? I think you missed capturing that... As you edit/add details, it is reflected in the invoice then n there.

Waiting for info?

see if you can split this into two sentences.

keep track of

You can add attachments to payouts during or after the Payout creation to make reconciliation easy. Attachments provide increased visibility for your Chartered Accountant.

Split the sentence

After step 5... ideally step 6 should be... whatever happens when you click "Next"...

That Auto Debit Settings enabling is a deviation from this flow which has been covered. But the actual task flow is missing. Can you add that?

your owner - gives an impression of a boss who has to login.

Suggestion: Make sure you login with owner credentials

Is this handy tips required? The information given here is already covered in the table and also the image. Repetitive info.

Ambiguous sentence structure. Can be reworded to:

Check the table below to understand the difference in data provided by old Razorpay app and the new Razorpay Secure app.

Change to active voice.

You can upload the signed NACH forms that you have collected from your customers

Is this process or ways in which you can collect the NACH form. If it is a process, the list below should be a numbered list and not bulleted. Else, change the lead-in sentence to the current ways to collect are

Who is a referrer? Defining the role here would be more appropriate.

sub-unit.

Change it at all places.

Let the hyperlink be limited to Payment Methods only. Remove hyperlink from the word 'activated'

d

sub-unit

You can start accepting...

Typically, you can use a sentence starting with a verb in a heading but not recommended for body. Must mention the subject in the body.

Interogative sentence. Change to:

Means by which you would like to resend the notification. Possible values are:

that is used to

p

UK spelling is authorisation. Change everywhere.

we support INR only.

'it' refers to payment or order? Unclear...

refer to Order documentation.

Key-value pair that is used to store...

Passive voice.

Once you create a customer, you can create an order for the authorisation of the payment.

Also spell-check authorisation.

Passive voice. Change to active.

Suggestion: You can generate the unique identifier for a customer using the Customer API.

i

n

Please check with PM if it is necessary to quote this... Whether we will reduce or not is uncertain. Settlement TAT is T+7 is enough information.

Callout header missing

Indent this... Now, the list looks disparate.

Period missing. Some have period, some do not. Make it consistent.

This is not an example as there is no scenario being described. Use another heading.

Heading needs to be shorter. Anyway the article talks about it in detail. Suggest limit heading to "Accept International Payments"

Netbanking.

Reason: This term is always used as a noun.

Using this method, your Indian customers can make payments

Same comment as above. Check sentences which do not mention 'they'... it comes across as something we are asking the reader (you) to do.

Gives me a second person impression. For eg, you select card, you view a list of saved cards... whereas in this context, it is they.

Maybe can add it to the lead in sentence... To delete the website/app on a particular card, they have to:

hyperlink this to the login URL for better usability

customers should be enough. End is redundant.

Is it not PayU?

Here the question can be just the second part. Because we are not answering the first part of the question at all.

Recommend:

Where can I pass the custom identifier in the order? The custom identifier needs to be passed in the Payments or Orders API.

through?

Custom Identifiers

a set of custom rules for transactions.

Transactions should follow - makes transactions sound 'human'. Can be avoided.

100% of transactions are routed through Razorpay

you can ensure that 100% of all transactions is routed through

Let this be a bulleted list instead of a numbered list.

Numbered list makes it looks like it is a sequence of tasks to be performed.

change to is

processed at normal speed

Remove colon

product is yet to be set active or user is yet to be set as active?

is provided

Consider breaking this sentence into 2 or 3 smaller sentences. Too big and hampers readability.

replace article with the

its - wrong pronoun. Can change this to "....account that partners create for their customers...."

Aren't we changing this to Handy Tips?

Numbering issue

You can enable or disable a plan only after it is created.

Image - New Plan header is cut off... Either take it off completely or add a new image where the title is seen.

Can you crop off the grey-white checked part of the image?

Looks like a command from step 3 is repeated... please verify.

The version table is blank. Let us add not applicable or something of that sort to make it look consistent. Right now, it looks like information is missing.

And this Handy Tips?

Are we not calling this Watch Out!.........?

delete

commonly called Windows Search. Can we not use that?

Click Browse to open the Windows Search. Select the zip file......

Saw ID capitalised somewhere in this page. Change this to ID or the other instance to id to maintain consistency.

Punctuation error.

You can request an update, provide information, or add attachment such as error screenshot.

to view ticket details. Active voice

This implies owner and admin can ONLY do this ONE task.

Change to "Only Owner and Admin can raise support tickets"

Please ping for any clarification.

Isn't this misleading? Queries may not be resolved 'instantly'. Some may take time...

Why don't we say "to talk to our Customer Support Executive instantly" or something on those lines?

addressed,

Avoid ?. together You can skip the period in such rare cases

subject verb disagreement. Use "any concern" or just "concerns"

Can you bullet list this? Too big a sentence/too many conjunctions in use.

Question mark missing. Suits in this context

such as implies you have a list of items to quote. But since we are talking only about Razorpay Docs, considering changing it to - You get a host of resources on Razorpay Docs

with

Why is L capitalized here?

confusing when we read it for the first time. Can re-word this?

Reco: You can fetch the network of the card provided.... {we are anyway listing the network - so user will know it is card network}

Put within single quotes as used in the Razorpay Card Tokenisation Solution paragraph

card

For better readability: The advantages of using saved cards or tokens are: OR The advantages of using saved cards (tokens) are:

Can we have shorter and crispy headings for the left nav?

typo

Format is not the same as how it is used in the rest of the doc... Maybe missing the `

details.

Maximum 256 characters each - Suggestion.

typo

Change to active voice

adjective-noun disagreement.

Change to you must explicitly collect customer consent (OR) you must collect customer consent explicitly

You can set up fallback priority levels also.

Suggestion. Change to payments as plural would be better...

Can you pull this text down? It looks like it is sticking to the table. Whereas the bullet points look too much spaced out.

There is a topic on API Error Codes. Makes sense to include that information here....

You can have it under docs/x/api/error-codes

404

Delete this topic from here since we are anyway covering Postman Collection as a separate chapter.

This note is not required here. We are not listing APIs in this page.

Order

Capitalise order in all occurrences since it is being used as a noun.

Too many details in a single sentence. Can this be broken to two sentences? Suggestion...

Create an Order (match case with the one present in heading)

Verify Payment Signature (match case with the one used in heading)

verify the payment status from the Razorpay Dashboard or through APIs

The callouts be compulsorily called Handy Tips or Watch Out!...after we did restructuring?

for the amount to be settled to your bank account.

Add a hyperlink to the sign up page or the dashboard link to where we can sign up

Remove and add the after 'before'...

Initiate the debit process for an amount less than ₹5,000 before the actual debit date.

Yes, you can....

see and look - both not required. Retain any one.

to see a sample SMS notification and how customers can....

Add a period at the end of the sentence.

enabling Cards for the following banks....

If it is the product we are talking about, shouldn't it be Recurring Payments?