PaysafeCash POS cashout API information
Transaction status
| Value | Description |
|---|---|
INITIATED | The initial state of a transaction after it has been successfully created. |
AUTHORIZED | The customer has completed the transaction at a payment point. |
SUCCESS | The transaction has been completed successfully. |
CANCELED_MERCHANT | The transaction has been cancelled by the business partner. |
EXPIRED | The customer has not logged in to the barcode application for 30 minutes, the business partner has not generated the barcode after the transaction has been created, or the customer has not completed the transaction at a payment point in the predefined time frame (default 24 hours, unless specified otherwise by the business partner). |
HTTP status codes
| Code | Short description | Description |
|---|---|---|
| 200 | OK | The request was successful. |
| 201 | Created | Object successfully created. |
| 400 | Bad Request | Invalid data provided in the request. |
| 401 | Unauthorized | Invalid or expired API key. |
| 404 | Not Found | POS cashout feature disabled. |
| 500 | Internal Server Error | A general technical error on PaysafeCard's end. |
| 501 | Not Implemented | Version feature not implemented. |
| 502 | Bad Gateway | Invalid response from upstream system. |
| 503 | Service Unavailable | Server overloaded. |
| 504 | Gateway Timeout | Timeout from upstream system. |
Example error response:
400 Bad Request
{
"code": "invalid_request_parameter",
"message": "must contain 1-10 digits, followed by a decimal separator '.' followed by 2 digits",
"number": 10028,
"param": "amount"
}
Customer id
Also known as Merchant Client ID, the customer id identifies the customer on the business partner's side.
The most optimal customer id is a completely random value that uniquely identifies the customer and is disconnected from any personal information. This value should be the same for all transactions of the customer.
Valid values:
| Value | Type |
|---|---|
2c3be0b50c7a5f1964a63d78f38a6ffc41c027e9 | SHA1 - test@123.com |
742f2b1a55cd5d606ea44b4fcb54646a | MD5 - test@123.com |
3a5b0d0777dead9df93d502df85c8180e53804eb | SHA1 - UsernameValue1 |
3192481752123 | Random customer identifier |
CustomerID1 | Customer identifier free of personal information |
Invalid values:
test@123.comUsername_1FirstName123LastName123TimestampIP Address
Sending any form of the invalid values will not be accepted.
If you intend to process transactions on multiple brands, please inquire about the possibilities of separating multiple entities for your account.