Neuro-Pay Terminal API
outlining the functionality and implementaiton of the paiwise checkout API
Requests
Collection of possible requests
Create [POST]
https://api.neuro-admin.com/terminalpayment/terminal-payment/create [POST]
| amount | int | Smallest nominee for the currency. Example: 30SEK is 3000 öre so value of this param should be 3000. SEK is the only currency permitted. |
| terminal_id | String | ID of the terminal where to send the payment |
| reference (optional) |
String | Is a free text field to indicate a reference for the payment |
| sent_via | Enum ("sms", "email") | Indicate with which media the receipt will sent (allowed values: "sms", "email") |
| sent_to | String | Indicate phone number or mail where to send the receipt |
Check Status [POST]
https://api.neuro-admin.com/terminalpayment/terminal-payment/check-status [POST]
Values
| payment_id | String | The payment_id received when creating a terminal payment object |
Refund [POST]
https://api.paiwise.com/terminalpayment/terminal-payment/refund [POST]
The refund can be used on objects that has status “paid” or “partialRefund”
Values
| payment_id | String | The payment_id received when creating a terminal payment object |
| amount (optional) | Int | If an amount to be refunded is not set the whole actual balance will be refunded |
| reason (optional) | String | Reason of the refund. Value admitted: "duplicate", "requested_by_customer" or "fraudolent" |
| refundDetails (optional) | String | Comments about the refund. Free text |
| sent_via (optional) (beta) | String | Notification method. Value admitted: "email" or "sms" |
| sent_to (optional) (beta) | String | To whom send notification of the refund |
Cancel [POST]
https://api.neuro-admin.com/terminalpayment/terminal-payment/cancel [POST]
The update can be used on objects with every status to update/add/delete metadata information.
Values
| payment_id | String | The payment_id received when creating a terminal payment object |
Authentification
In order to use the terminal API the company in question needs to generate an API key through the Neuor-Admin platform. Said API key should be sent as a bearer token in each request.
Response
The response object
For each endpoint the terminal object will be returned in its “new state”
Example:
Possible statuses are
• created
• canceled
• paid
• refunded
• partialRefund
Every date and time returned are in UTC.
Terminal's request
Available Reader [GET]
https://api.neuro-admin.com/terminalpayment/terminal-payment/available-reader [GET]
The available-reader EP can be used to retrieve the list of available terminals that are online at the moment of the request
Data format
The API currently accepts and returns JSON data in the body
Postman collection
attached to this page is a postman collection for testing
All requests inherits the authentication from the collection. as the bearer token you add your API key test or live,
You can find file attachments in top left corner of this page