Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Razorpay Payments API

The Payments API from Razorpay — 6 operation(s) for payments.

Razorpay Payments API is one of 6 APIs that Razorpay publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Payments. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 7 operations across 6 paths, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.razorpay.com/v1.

7 operations 6 paths 4 schemas 4 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.razorpay.com/v1
Authentication
HTTP Basic
Contact
Resource Areas
1

Authentication & Security 1

Razorpay Payments API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic auth — username is Razorpay keyid, password is keysecret.

Paths & Operations 7

Across 6 paths, the API surfaces 7 operations — 4 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Payments 7
GET
/payments
List payments
listPayments 4 params → 200
GET
/payments/{id}
Get a payment
getPayment 1 param → 200
PATCH
/payments/{id}
Update a payment (notes)
updatePayment 1 param body → 200
POST
/payments/{id}/capture
Capture an authorized payment
capturePayment 1 param body → 200
GET
/payments/{id}/card
Get card used for a payment
getPaymentCard 1 param → 200
POST
/payments/{id}/refund
Refund a captured payment
createRefund 1 param body → 200
GET
/payments/{id}/refunds
List refunds for a payment
listPaymentRefunds 1 param → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Payment (20 properties), Refund (11 properties), PaymentList (3 properties), RefundList (3 properties). Each schema is shown below with its type and property counts.

RefundList
object
3 properties
PaymentList
object
3 properties
Payment
object
20 properties
Refund
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

razorpay-payments-api-openapi.yml Raw ↑

Other APIs Razorpay publishes across the network.

Razorpay Core REST API
Razorpay Payments API
Razorpay Webhooks
Razorpay Orders API
Razorpay Refunds API