Blog/

Stop Checking Payments Manually: Verifying Payments With the Return Prime API

Adhya Joshi
November 16, 2026
3 Mins
read
return rate optimization checklist for fashion brands

Kwik Summary: If someone on your team opens a payment gateway dashboard to confirm whether a returns-related payment came through, that check can run automatically. One of our merchants uses the API to verify whether a payment has been received through PayU, and it is the second busiest API integration we tracked, at 32,663 requests in one week. Pair the API with the "request refunded" and "request refund failed" webhooks and finance hears about money moving without asking.

Where do payments show up in a returns flow?

Returns are not only money going out. On Return Prime, money can also come in during a return:

  • Exchange price differences. You decide when customers pay a price difference on an exchange, or waive it fully.
  • Return fees. You can charge return fees, and Thrive AI adds intelligent return fees.

Selling high-ticket products? Our guide to restocking fees for US merchants covers what you can charge and how to disclose it.

Money also goes out as refunds, through modes such as gift card, discount code, store credit, bank transfer or UPI, depending on plan. Each of these is a point where ops or finance may need to confirm what actually happened.

What does the merchant in our data actually do?

They call Return Prime's API to check whether a payment has been successfully received from PayU, their payment gateway. At 32,663 requests in a week, this is clearly running as an automated job, not a person clicking around. The point is simple: the check moved from a human to a system.

How do you set up payment checks with the API?

  1. In your Return Prime dashboard, go to Settings, then Integrations, then Develop Apps.
  2. Create a new app and copy the API access token from API Credentials.
  3. Send the token in the x-rp-token header on your API calls. This is the same header the Gorgias integration uses.
  4. Use the endpoints listed in the Return Prime API docs to read request and transaction status from your own system.

Sending data to your own systems for reconciliation after every return activity is one of the core use cases our API is built for.

Which webhooks matter for finance teams?

Of the nine events in our webhooks guide, two are built for money:

  • Request refunded: Log the refund against the order in your books
  • Request refund failed: Raise an alert so someone fixes it before the customer chases you

Return Prime sends each event as a POST request with a JSON payload. Your endpoint should respond with 200 OK, and we recommend HTTPS, retry logic and a log of incoming events.

Does the new payment flow change any of this?

It may simplify it. Our new payment flow runs all exchange payments through Shopify Checkout, using the payment methods already enabled on your store, with no separate gateway setup in Return Prime. If you have moved to it, check whether exchange payments now appear where your team already reconciles Shopify orders before you build a separate gateway check.

Refund timing is a cash flow question too, especially in peak season. See returns and cash flow: managing refund timing through the holidays.

FAQs

Can I check payment status on returns without opening my gateway dashboard?‍

Yes. One of our merchants uses the API to verify whether a payment was received through PayU, and runs it as an automated job.

Which Return Prime webhooks help with refund reconciliation?‍

Request refunded and request refund failed. Return Prime sends each as a POST request with a JSON payload to the URL you set.

Where do I get a Return Prime API token?‍

In the Return Prime dashboard under Settings, Integrations, Develop Apps. Create an app and copy the API access token from API Credentials.

How are exchange payments collected in Return Prime's new payment flow?‍

Through Shopify Checkout, using the payment methods already enabled on the store, with no additional payment gateway configuration in Return Prime.

Subscribe to Return Prime

Get the latest posts delivered right to your inbox

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
By submitting this form, you agree to Return Prime’s privacy policy.
Maximize your Revenue by one return at a time