MaksuPay VPOS JSON API
MaksuPay VPOS API (5.0)
Download OpenAPI specification:
MaksuPay Support: support@maksupay.com URL: https://maksupay.com
MaksuPay VPOS API endpoint for processing sale, prreuth, refund, cancel and other operations. This API allows merchants to send JSON-formatted messages and receive corresponding response messages.
Supported request messages
Payment operations
- SaleRequest
- AuthorisationRequest
- CaptureRequest
- PayLinkRequest
- OriginalCreditRequest
- RefundRequest
- CancelRequest (void)
- RecurringOperationRequest (Cancel to cancel|Recurring run follow-up)
- StatusRequest
Tokenization operations
- TokenizationRequest
- DeTokenizationRequest
3DS Authentication operations
- ThreeDSMethodRequest
- AuthenticationRequest
- AuthenticationResultsRequest
Send request
Sends a saleReq or other message to initiate a payment authorization and capture or other operation of transaction. Returns a saleRes or other response object.
header Parameters
| X-Payload-Signature required | string Example: SHA256;ITdgCSe2n+ssLzbEAkGUn9lAKUZ7ToP3xikYrT1xUj5i6l6LXsT98gZTakayKU+rE7xFv0LuBCJVnjuI9WReTmYkzgrEgxrSXLhmo3PTdDmAiadS1VOg+pO8mxEae//2oBmkZVBS2NUTK6kOr5mNPifv3EqZMERh+AN7r/WJxy7NipVkot+CakO81wWp/YtsygJutdRb7G8k364j2K1F3bWJuqhbi55KLCRpIVzyfW5kznUpcqVDeeQcEl+vMlFqVV7p6DevWRap4ooOzxQCKwR4yTovQUiLLVcBmnBKJT0Igbpls+rCWa1SGWY4jSH7MWMhoFgqtUVAZF+aFHNz7YhGDSwT5V6cAFJh5bvN5BN1KH+QWQ8yNDaEMsHx2amn61mXUwBKTMmNF0yFHqTes6mBfZ/no8GM RSA with-SHA256 signature of request body |
| X-Sender-ID required | string Example: 200002 Sender id (typically merchant id eg 200002) |
| X-Public-Key-Hash required | string Example: BecEjchDmUWaq9EPUiP+b7kVFbjQWT9ksMJrRgVbChE= Sender public key hash |
Request Body schema: application/jsonrequired
required | saleReq (object) or authorisationReq (object) or captureReq (object) or originalCreditReq (object) or refundReq (object) or cancelReq (object) or recurringOperationReq (object) or statusReq (object) or tokenizationReq (object) or deTokenizationReq (object) or payLinkReq (object) or tdsmethodReq (object) or authReq (object) or authResultsReq (object) or walletDataReq (object) |
Responses
Request samples
- Payload
Content type
application/json
Example
{- "message": {
- "saleReq": {
- "merchantId": "200002",
- "orderInfo": {
- "orderDesc": "",
- "orderAmount": 1.25,
- "currency": "EUR",
- "orderId": "O1762845232533"
}, - "paymentInfo": {
- "card": {
- "pan": "4016360000000010",
- "cvv2": "756",
- "expDate": "2712",
- "holderName": "John Smith"
}, - "payerEmail": "user@host.com",
- "payerIpAddress": "192.168.8.98",
- "billingAddress": {
- "country": "AT",
- "address": "Street 20",
- "city": "Vienna",
- "zip": "1200",
- "state": "WN"
}
}
}, - "id": "M1762845497158",
- "version": "5.0",
- "ts": "2025-11-11T07:18:17Z",
- "senderId": "200002"
}
}Response samples
- 200
Content type
application/json
Example
{- "message": {
- "saleRes": {
- "merchantId": "200002",
- "description": "OK, CAPTURED response code 00",
- "status": "CAPTURED",
- "orderAmount": 1.25,
- "currency": "EUR",
- "paymentTotal": 1.25,
- "paymentRef": "231704",
- "riskScore": 0,
- "attributes": [ ],
- "orderId": "O1762845232533",
- "txId": 242901
}, - "id": "M1762845497158",
- "version": "5.0",
- "ts": "2025-11-11T07:18:25Z",
- "senderId": "C=EE,ST=HM,L=Tallinn,O=ChaosPay,OU=E-COM Signer,CN=ChaosPay E-COM Signer 2024-01"
}
}