Create Order

post

https://pluraluat.v2.pinepg.in/api/pay/v1/orders

Use this API to create an Order.

Environment

Use our UAT environment endpoint for testing and for integration utilize our production endpoint.

Environment	Endpoints
User Acceptance Testing [UAT]	`https://pluraluat.v2.pinepg.in/api/pay/v1/orders`
Production [PROD]	`https://api.pluralpay.in/api/pay/v1/orders`

Body Params

merchant_order_reference

string

required

Enter a unique identifier for the order request.

Minimum: 1 characters.
Maximum: 50 characters

Example: 789d55be-55ee-4e07-9c41-58d2445c2ca3

Supported characters:

A-Z
a-z
-
_

order_amount

object

required

An object that contains the transaction amount details.

pre_auth

boolean

The pre-authorization type.

Possible values:
false (default): When pre-authorization is not required.
true: When pre-authorization is needed.

allowed_payment_methods

array of strings

The type of payment methods you want to offer your customers to accept payments.

Accepted values:

CARD
UPI
POINTS
NETBANKING
WALLET
CREDIT_EMI
DEBIT_EMI
CARDLESS_EMI

Example: CARD

Note: Before selecting a payment method, ensure it is configured for you.

allowed_payment_methods

notes

string

The note you want to show against an order.

Example: Order1

callback_url

string

URL to redirect your customers to specific success or failure pages based on the order or product details.

Example: https://sample-callback-url

purchase_details

object

Object that contains the details of customer information, shipping address, and billing address.

cart_coupon_discount_amount

object

An object that requires the cart coupon discount amount details.

Headers

Content-Type

string

The type of content included in the HTTP message body.

Possible value: application/json.

Authorization

string

required

Defaults to Bearer

The HTTP header where you can include your secret token for authentication.

Example: Bearer <access_token>

Note: Use the access token generated using our Generate Token API.

Request-Timestamp

string

Use ISO 8601 UTC Timestamp, to create a timestamp when the generate token is requested.

Example: 2024-07-09T07:57:08.022Z

Request-ID

string

Use a global unique identifier [GUID] for the request.

Minimum: 1 characters.
Maximum: 50 characters

Example: c17ce30f-f88e-4f81-ada1-c3b4909ed235

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Environment

200200

400400

401401

422422

500500