curl --location --request POST 'https://identity.payroc.com/authorize' --header 'x-api-key: <api key>'
{"access_token": "eyJhbGc....adQssw5c","expires_in": 3600,"scope": "service_a service_b","token_type": "Bearer"}
curl-H "Content-Type: application/json"-H "Authorization: <Bearer token>"-H "Idempotency-Key: <UUID v4>"
curl --request get \--url https://api.payroc.com/v1/payments \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"paymentId": "IFA1T74OBS","processingTerminalId": "1001","operator": "Automatic Payment","order": {"orderId": "684255528917","dateTime": "2023-05-16T16:45:29.000Z","description": "recurring order","amount": 100,"currency": "EUR"},"card": {"type": "Visa Credit","cardholderName": "Joe Bloggs","cardNumber": "453985******7062","expiryDate": "0129","secureToken": {"secureTokenId": "FirefoxSecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/FirefoxSecureCard1001"}},"securityChecks": {"cvvResult": "M","avsResult": "X"}},"supportedOperations": ["fullyReverse","setAsPending"],"transactionResult": {"type": "sale","status": "ready","approvalCode": "475318","authorizedAmount": 100,"currency": "EUR","responseCode": "A","responseMessage": "APPROVAL"}},{"paymentId": "CW4BA4MUH0","processingTerminalId": "1001","operator": "Automatic Payment","order": {"orderId": "684255528143","dateTime": "2023-05-16T16:45:28.000Z","description": "yearly avant-gard cinema subscription","amount": 1000,"currency": "EUR"},"card": {"type": "Visa Debit","cardholderName": "Joe Bloggs","cardNumber": "400006******0006","expiryDate": "0129","secureToken": {"secureTokenId": "FirefoxSecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/FirefoxSecureCard1001"}},"securityChecks": {"cvvResult": "M","avsResult": "X"}},"supportedOperations": ["fullyReverse","setAsPending"],"transactionResult": {"type": "sale","status": "ready","approvalCode": "475318","authorizedAmount": 1000,"currency": "EUR","responseCode": "A","responseMessage": "APPROVAL"}}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/payments?processingTerminalId=1001&limit=2&after=CW4BA4MUH0"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/payments?processingTerminalId=1001&limit=2&before=IFA1T74OBS"}]}
curl --request post \--url https://api.payroc.com/v1/payments/abc123/reverse \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: abc123' \--data '{"amount":10}'
application/json
{"paymentId": "FRED4RL3GO","processingTerminalId": "1023","order": {"orderId": "MAPI_V2_PAY_23","dateTime": "2023-05-18T09:29:25.000Z","description": "Example payment","amount": 100,"currency": "USD"},"customer": {"firstName": "Giuseppe","lastName": "Verdi","billingAddress": {"address1": "example street","address2": "example address2","address3": "example address3","city": "example city","state": "California","country": "USA","postalCode": "1"},"shippingAddress": {"recipientName": "shipping recipientName","address": {"address1": "shipping address1","address2": "shipping address2","address3": "shipping address3","city": "shipping city","state": "shipping state","country": "IT","postalCode": "1"}}},"card": {"type": "MasterCard","entryMethod": "keyed","cardNumber": "500165******0000","expiryDate": "0328","securityChecks": {"cvvResult": "M","avsResult": "Y"}},"supportedOperations": ["capture","fullyReverse","partiallyReverse","incrementAuthorization","adjustTip","setAsPending"],"transactionResult": {"type": "sale","status": "reversal","approvalCode": "OK2","authorizedAmount": 100,"currency": "USD","responseCode": "A","responseMessage": "OK2"}}
{"paymentId": "LRJ1QWEFRN","processingTerminalId": "3204001","operator": "notRequired","order": {"orderId": "Test_007","dateTime": "2023-05-25T10:39:10+01:00","amount": 4000,"currency": "USD","standingInstructions": {"sequence": "subsequent","processingModel": "recurring"}},"card": {"type": "Visa Credit","entryMethod": "keyed","cardNumber": "444433******1111","expiryDate": "1226","secureToken": {"secureTokenId": "MREF_1a93f3a6-9029-419f-9e87-3e2db6f0ae85uA","customerName": "","token": "2967538502417872","status": "cvv_validated","link": {"rel": "self","method": "GET","href": "https://api.uat.payroc.com/v1/processing-terminals/3204001/secure-tokens/MREF_1a93f3a6-9029-419f-9e87-3e2db6f0ae85uA"}},"securityChecks": {"cvvResult": "M","avsResult": "Y"}},"transactionResult": {"type": "sale","status": "reversal","approvalCode": "OK14866","authorizedAmount": 4000,"currency": "USD","responseCode": "A","responseMessage": "OK14866","cardSchemeReferenceId": "zz67WbxsEwMkvbSNcxz9"}}