Run a card sale
A merchant can use their POS to run card sales.
Integration steps
- Run a sale.
Before you begin
Bearer tokens
Use our Identity Service to generate a Bearer token to include in the header of your requests. To generate your Bearer token, complete the following steps:
- Include your API key in the x-api-key parameter in the header of a POST request.
- Send your request to https://identity.payroc.com/authorize.
Note: You need to generate a new Bearer token before the previous Bearer token expires.
Example request
Example response
If your request is successful, we return a response that contains your Bearer token, information about its scope, and when it expires.
Headers
To create the header of each POST request, you must include the following parameters:
- Content-Type: Include application/json as the value for this parameter.
- Authorization: Include your Bearer token in this parameter.
- Idempotency-Key: Include a UUID v4 to make the request idempotent.
Errors
If your request is unsuccessful, we return an error. For more information about errors, see Errors.
Run a sale
To run a sale, send a POST request to our Payments endpoint.
Important: This method includes the following functions:
- Tokenization
- Pre-authorization
- Currency conversion
- Offline processing
We don’t describe how to integrate with these functions in this guide.
Request parameters
To create the body of your request, use the following parameters:
Request
Example request
Response fields
If your request is successful, our gateway uses the card details to run a sale. The response contains the following fields:
Response
Example response
Test cases
Before you run test cases, read the Payments page in Test Your Integration.
Run a card sale without a surcharge
Send a POST request to the following endpoint:
POST https://api.uat.payroc.com/v1/payments
Example response
Run a card sale with a surcharge
Send a POST request to the following endpoint:
POST https://api.uat.payroc.com/v1/payments
Note: If you are unsure whether your account supports surcharges, email our Integration team at [email protected].
Example response