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>"
curl-H "Content-Type: application/json"-H "Authorization: <Bearer token>"-H "Idempotency-Key: <UUID v4>"
curl --request get \--url https://api.payroc.com/v1/bank-transfer-payments/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"paymentId": "M2MJOG6O2Y","processingTerminalId": "1017","order": {"orderId": "orderpop123","dateTime": "2023-07-25T13:08:45.179Z","description": "sample order","amount": 11110,"currency": "USD","breakdown": {"subtotal": 10000,"tip": {"type": "percentage","amount": 1010,"percentage": 10},"taxes": [{"name": "VAT","rate": 1,"amount": 100}]}},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****1010","routingNumber": "053200983","secureToken": {"secureTokenId": "MREF_8d9b44e4-fd9c-45a7-b4b5-5e3d591dd385tK","customerName": "Joe Bloggs","token": "2967534039611822","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1017/secure-tokens/MREF_8d9b44e4-fd9c-45a7-b4b5-5e3d591dd385tK"}}},"transactionResult": {"type": "payment","status": "ready","authorizedAmount": 11110,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}}
curl --request get \--url 'https://api.payroc.com/v1/bank-transfer-payments?processingTerminalId=abc123' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"paymentId": "GTNOY9O4R4","processingTerminalId": "1017","order": {"orderId": "602","dateTime": "2023-05-16T15:53:18.000Z","description": "sample order","amount": 12100,"currency": "CAD","breakdown": {"subtotal": 10000,"tip": {"type": "percentage","amount": 1100,"percentage": 10},"taxes": [{"name": "VAT","rate": 10,"amount": 1000}]}},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "pad","nameOnAccount": "Joe Bloggs","accountNumber": "*******8909","transitNumber": "12345","institutionNumber": "123"},"transactionResult": {"type": "payment","status": "ready","authorizedAmount": 12100,"currency": "CAD","responseCode": "A"}},{"paymentId": "E29U8OU8Q4","processingTerminalId": "1017","order": {"orderId": "541","dateTime": "2023-05-16T15:52:56.000Z","description": "test","amount": 12100,"currency": "CAD","breakdown": {"subtotal": 10000,"tip": {"type": "percentage","amount": 1100,"percentage": 10},"taxes": [{"name": "VAT","rate": 10,"amount": 1000}]}},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "pad","nameOnAccount": "Joe Bloggs","accountNumber": "*******8909","transitNumber": "12345","institutionNumber": "123"},"transactionResult": {"type": "payment","status": "ready","authorizedAmount": 12100,"currency": "CAD","responseCode": "A"}}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/bank-transfer-payments?limit=2&processingTerminalId=1017&after=E29U8OU8Q4"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1//bank-transfer-payments?limit=2&processingTerminalId=1017&before=GTNOY9O4R4"}]}
curl --request post \--url https://api.payroc.com/v1/bank-transfer-payments/abc123/refund \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: abc123' \--data '{"amount":10000,"description":"amount to refund"}'
application/json
{"paymentId": "M12F8SUHGM","processingTerminalId": "1017","order": {"orderId": "243","dateTime": "2023-07-25T21:57:11.000Z","description": "amount to refund","amount": 11110,"currency": "CAD","breakdown": {"subtotal": 10000,"tip": {"type": "percentage","amount": 1010,"percentage": 10},"taxes": [{"name": "VAT","rate": 1,"amount": 100}]}},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "pad","nameOnAccount": "Joe Bloggs","accountNumber": "****9031","transitNumber": "14574","institutionNumber": "644","secureToken": {"secureTokenId": "MREF_465772d1-ab4e-4881-8052-5021a745ed18Df","customerName": "Joe Bloggs","token": "2967536686508441","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1017/secure-tokens/MREF_465772d1-ab4e-4881-8052-5021a745ed18Df"}}},"transactionResult": {"type": "payment","status": "reversal","authorizedAmount": 11110,"currency": "CAD","responseCode": "A"}}