POS
Initiate Payment
Initiate payment for a previously created POS order.
Initiate Payment
Second step of the two-step flow. Generates a PSP token for an existing order.
Endpoint
| Method | URL |
|---|---|
| POST | https://api.payorc.com/pos/v1/initiate-payment |
Headers
| Header | Type | Required | Description |
|---|---|---|---|
merchant-key | String | Yes | POS Web API key |
merchant-secret | String | Yes | POS Web API secret |
Content-Type | String | Yes | application/json |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
order_id | String | Yes | p_order_id from Create Order |
pos_terminal_id | String | Yes | POS terminal ID |
txn_type | String | Yes | CARD or UPI |
Business rules
- Order must be in
PENDINGorFAILEDstatus. - Rejected if order is already paid (
CAPTURED/AUTHORISED) orCANCELLED.
Response — Success (200)
{
"data": {
"p_order_id": "1000010035",
"psp_token_id": "TOKEN_FROM_PSP",
"pos_terminal_id": "E3929707",
"order_status": "PENDING"
},
"message": "Payment initiated",
"status": "success",
"code": "00"
}cURL
curl -X POST "https://api.payorc.com/pos/v1/initiate-payment" \
-H "merchant-key: {{posweb-key}}" \
-H "merchant-secret: {{posweb-secret}}" \
-H "Content-Type: application/json" \
-d '{
"order_id": "1000010035",
"pos_terminal_id": "E3929707",
"txn_type": "CARD"
}'