curl --request get \--url https://api.payroc.com/v1/contacts/1543 \--header 'Authorization: Bearer <access token>'
application/json
{"contactId": 1543,"type": "manager","firstName": "Jane","middleName": "Helen","lastName": "Doe","identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "email",},{"type": "phone","value": "2025550164"},{"type": "mobile","value": "8445557624"},{"type": "fax","value": "2025550110"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request put \--url https://api.payroc.com/v1/contacts/1543 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"type":"manager","firstName":"Jane","middleName":"Helen","lastName":"Doe","identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}]}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request delete \--url https://api.payroc.com/v1/contacts/1543 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
POST /merchant-platformsUse this method to create the entity that represents a business, including its legal information and all its processing accounts.
The response contains some fields that we require for other methods:Note: To add a processing account to an existing merchant platform, go to Create a processing account.
curl --request post \--url https://api.payroc.com/v1/merchant-platforms \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"business":{"name":"Example Corp","taxId":"12-3456789","organizationType":"privateCorporation","countryOfOperation":"US","addresses":[{"type":"legalAddress","address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"}],"contactMethods":[{"type":"email","value":"[email protected]"}]},"processingAccounts":[{"doingBusinessAs":"Pizza Doe","owners":[{"firstName":"Jane","middleName":"Helen","lastName":"Doe","dateOfBirth":"1964-03-22","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}],"relationship":{"equityPercentage":35.4,"title":"CFO","isControlProng":true,"isAuthorizedSignatory":false}}],"website":"www.example.com","businessType":"restaurant","categoryCode":5999,"merchandiseOrServiceSold":"Pizza","businessStartDate":"2020-01-01","timezone":"America/Chicago","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"contactMethods":[{"type":"email","value":"[email protected]"}],"processing":{"transactionAmounts":{"average":5000,"highest":10000},"monthlyAmounts":{"average":50000,"highest":100000},"volumeBreakdown":{"cardPresentKeyed":47,"cardPresentSwiped":30,"mailOrTelephone":3,"ecommerce":20},"isSeasonal":true,"monthsOfOperation":["jan","feb"],"ach":{"naics":"44-45","previouslyTerminatedForAch":false,"refunds":{"writtenRefundPolicy":true,"refundPolicyUrl":"www.example.com/refund-poilcy-url"},"estimatedMonthlyTransactions":3000,"limits":{"singleTransaction":10000,"dailyDeposit":200000,"monthlyDeposit":6000000},"transactionTypes":["prearrangedPayment","other"],"transactionTypesOther":"anotherTransactionType"},"cardAcceptance":{"debitOnly":false,"cardsAccepted":["visa","mastercard"],"specialityCards":{"americanExpressDirect":{"enabled":true,"merchantNumber":"abc1234567"},"electronicBenefitsTransfer":{"enabled":true,"fnsNumber":"abc1234"},"other":{"wexMerchantNumber":"abc1234567","voyagerMerchantId":"abc1234567","fleetMerchantId":"abc1234567"}}}},"funding":{"fundingSchedule":"nextday","acceleratedFundingFee":1999,"dailyDiscount":false,"fundingAccounts":[{"type":"checking","use":"creditAndDebit","nameOnAccount":"Jane Doe","paymentMethods":[{"type":"ach","value":{"routingNumber":"123456789","accountNumber":"1234567890"}}],"metadata":{"internalRef":"2345"}}]},"pricing":{"type":"intent","pricingIntentId":6123},"signature":"requestedViaDirectLink","contacts":[{"type":"manager","firstName":"Jane","middleName":"Helen","lastName":"Doe","identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}]}],"metadata":{"customerId":"2345"}}],"metadata":{"customerId":"2345"}}'
application/json
{"merchantPlatformId": "12345","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","business": {"name": "Example Corp","taxId": "xxxxx6789","organizationType": "privateCorporation","countryOfOperation": "US","addresses": [{"type": "legalAddress","address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"}],"contactMethods": [{"type": "email",}]},"processingAccounts": [{"processingAccountId": "38765","doingBusinessAs": "Pizza Doe","status": "pending","link": {"rel": "processingAccount","href": "https://api.payroc.com/v1/processing-accounts/38765","method": "get"},"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000000","method": "get"}}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Funding accounts limit reached | Funding accounts restricted. You can not have any more than two funding accounts attached to this entity |
Too many control prongs | Your request included more than one owner as the control prong. You can set only one owner as the control prong. |
No control prong or authorized signatory | Your request didn’t indicate which owner is the control prong or the authorized signatory. Set one owner as the control prong or the authorized signatory. |
Cannot select Daily Discount and RewardPay or RewardPayChoice at the same time. | You can't select Daily Discount with a RewardPay or RewardPayChoice pricing plan. To select Daily Discount, choose a different pricing plan. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Tax ID in use | The tax ID supplied is already in use. |
National ID in use | One or more supplied national IDs are not unique. All national IDs must be unique. |
Api error | Unable to process your request. |
GET /merchant-platformsUse this method to retrieve a paginated list of the merchant platforms that are linked to the ISV's account.
curl --request get \--url https://api.payroc.com/v1/merchant-platforms \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/merchant-platforms?before=12345&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/merchant-platforms?after=12346&limit=2"}],"data": [{"merchantPlatformId": "12345","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","business": {"name": "Example Corp","taxId": "xxxxx6789","organizationType": "privateCorporation","countryOfOperation": "US","addresses": [{"type": "legalAddress","address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"}],"contactMethods": [{"type": "email",},{"type": "phone","value": "123 456 7890"}]},"processingAccounts": [{"processingAccountId": "38765","doingBusinessAs": "Pizza Doe","status": "pending","link": {"rel": "processingAccount","href": "https://api.payroc.com/v1/processing-accounts/38765","method": "get"},"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000000","method": "get"}}}]},{"merchantPlatformId": "12346","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","business": {"name": "Example Corp","taxId": "xxxxx6789","organizationType": "privateCorporation","countryOfOperation": "US","addresses": [{"type": "legalAddress","address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"}],"contactMethods": [{"type": "email",},{"type": "phone","value": "123 456 7890"}]},"processingAccounts": [{"processingAccountId": "38766","doingBusinessAs": "Doe Hot Dogs","status": "pending","link": {"rel": "processingAccount","href": "https://api.payroc.com/v1/processing-accounts/38766","method": "get"},"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000001","method": "get"}}}]}]}
Error | Description |
---|---|
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /merchant-platforms/{merchantPlatformId}Use this method to retrieve information about a merchant platform, including its legal information and processing accounts. Include the merchantPlatformId that we sent you when you created the merchant platform.
curl --request get \--url https://api.payroc.com/v1/merchant-platforms/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"merchantPlatformId": "12345","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","business": {"name": "Example Corp","taxId": "xxxxx6789","organizationType": "privateCorporation","countryOfOperation": "US","addresses": [{"type": "legalAddress","address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"}],"contactMethods": [{"type": "email",}]},"processingAccounts": [{"processingAccountId": "38765","doingBusinessAs": "Pizza Doe","status": "approved","link": {"rel": "processingAccount","href": "https://api.payroc.com/v1/processing-accounts/38765","method": "get"},"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000000","method": "get"}}}],"metadata": {"customerId": "2345"},"links": []}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /merchant-platforms/{merchantPlatformId}/processing-accountsUse this method to retrieve a paginated list of processing accounts associated with a merchant platform. When you created the merchant platform, we sent you its merchantPlatformId in the response. Send this merchantPlatformId as a path parameter in your endpoint.
Note: By default, we return only open processing accounts. To include closed processing accounts, send a value oftrue
for the includeClosed query parameter.
curl --request get \--url https://api.payroc.com/v1/merchant-platforms/abc123/processing-accounts \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/merchant-platforms/12345/processing-accounts?before=38765&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/merchant-platforms/12345/processing-accounts?after=38766&limit=2"}],"data": [{"processingAccountId": "38765","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","doingBusinessAs": "Pizza Doe","owners": [{"ownerId": 4564,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/owners/4564","method": "get"}}],"website": "www.example.com","businessType": "restaurant","categoryCode": 5999,"merchandiseOrServiceSold": "Food","businessStartDate": "2020-01-01","timezone": "America/Chicago","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "email",},{"type": "phone","value": "123 456 7890"}],"processing": {"merchantId": "444412365478965","transactionAmounts": {"average": 1000,"highest": 200000},"monthlyAmounts": {"average": 1000000,"highest": 200000000},"volumeBreakdown": {"cardPresentKeyed": 47,"cardPresentSwiped": 30,"mailOrTelephone": 3,"ecommerce": 20},"isSeasonal": true,"monthsOfOperation": ["jan","feb","mar","nov","dec"],"ach": {"naics": "441222","previouslyTerminatedForAch": false,"refunds": {"writtenRefundPolicy": true,"refundPolicyUrl": "http://www.example.com/refunds"},"estimatedMonthlyTransactions": 1000,"limits": {"singleTransaction": 10000000,"dailyDeposit": 1000,"monthlyDeposit": 2000},"transactionTypes": ["telephoneInitiatedPayment","webInitiatedPayment"]},"cardAcceptance": {"debitOnly": false,"cardsAccepted": ["visa","mastercard"],"specialityCards": {"americanExpressDirect": {"enabled": true,"merchantNumber": "1234567890"},"electronicBenefitsTransfer": {"enabled": true,"fnsNumber": "1234567"},"other": {"wexMerchantNumber": "1234567890","voyagerMerchantId": "1234567890","fleetMerchantId": "1234567890"}}}},"funding": {"status": "enabled","fundingSchedule": "nextday","acceleratedFundingFee": 1999,"fundingAccounts": [{"fundingAccountId": 123,"status": "pending","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/123"}}]},"pricing": {"link": {"rel": "pricing","method": "get","href": "https://api.payroc.com/v1/processing-account/12345/pricing"}},"signature": {"type": "requestedViaEmail"},"contacts": [{"contactId": 1543,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/contacts/1543","method": "get"}}]},{"processingAccountId": "38766","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","doingBusinessAs": "Doe Hot Dogs","owners": [{"ownerId": 4564,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/owners/4564","method": "get"}}],"website": "www.example.com","businessType": "internet","categoryCode": 5999,"merchandiseOrServiceSold": "Food","businessStartDate": "2020-01-01","timezone": "America/Chicago","address": {"address1": "3 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "email",},{"type": "phone","value": "555 555 3456"}],"processing": {"merchantId": "444412365478966","transactionAmounts": {"average": 2000,"highest": 300000},"monthlyAmounts": {"average": 2000000,"highest": 300000000},"volumeBreakdown": {"cardPresentKeyed": 0,"cardPresentSwiped": 0,"mailOrTelephone": 0,"ecommerce": 100},"isSeasonal": true},"funding": {"status": "enabled","fundingSchedule": "nextday","acceleratedFundingFee": 1999,"fundingAccounts": [{"fundingAccountId": 124,"status": "pending","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/124"}}]},"pricing": {"link": {"rel": "pricing","method": "get","href": "https://api.payroc.com/v1/processing-account/12346/pricing"}},"signature": {"type": "requestedViaEmail"},"contacts": [{"contactId": 1543,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/contacts/1543","method": "get"}}]}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
POST /merchant-platforms/{merchantPlatformId}/processing-accountsUse this method to create a processing account and add it to a merchant platform.
In the response we return a processingAccountId for the processing account, which you need for the following methods.Note: You can create and add a processing account only to an existing merchant platform. If you have not already created a merchant platform, go to Create a merchant platform.
curl --request post \--url https://api.payroc.com/v1/merchant-platforms/abc123/processing-accounts \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"doingBusinessAs":"Pizza Doe","owners":[{"firstName":"Jane","middleName":"Helen","lastName":"Doe","dateOfBirth":"1964-03-22","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}],"relationship":{"equityPercentage":35.4,"title":"CFO","isControlProng":true,"isAuthorizedSignatory":false}}],"website":"www.example.com","businessType":"restaurant","categoryCode":5999,"merchandiseOrServiceSold":"Pizza","businessStartDate":"2020-01-01","timezone":"America/Chicago","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"contactMethods":[{"type":"email","value":"[email protected]"}],"processing":{"transactionAmounts":{"average":5000,"highest":10000},"monthlyAmounts":{"average":50000,"highest":100000},"volumeBreakdown":{"cardPresentKeyed":47,"cardPresentSwiped":30,"mailOrTelephone":3,"ecommerce":20},"isSeasonal":true,"monthsOfOperation":["jan","feb"],"ach":{"naics":"44-45","previouslyTerminatedForAch":false,"refunds":{"writtenRefundPolicy":true,"refundPolicyUrl":"www.example.com/refund-poilcy-url"},"estimatedMonthlyTransactions":3000,"limits":{"singleTransaction":10000,"dailyDeposit":200000,"monthlyDeposit":6000000},"transactionTypes":["prearrangedPayment","other"],"transactionTypesOther":"anotherTransactionType"},"cardAcceptance":{"debitOnly":false,"cardsAccepted":["visa","mastercard"],"specialityCards":{"americanExpressDirect":{"enabled":true,"merchantNumber":"abc1234567"},"electronicBenefitsTransfer":{"enabled":true,"fnsNumber":"abc1234"},"other":{"wexMerchantNumber":"abc1234567","voyagerMerchantId":"abc1234567","fleetMerchantId":"abc1234567"}}}},"funding":{"fundingSchedule":"nextday","acceleratedFundingFee":1999,"dailyDiscount":false,"fundingAccounts":[{"type":"checking","use":"creditAndDebit","nameOnAccount":"Jane Doe","paymentMethods":[{"type":"ach","value":{"routingNumber":"123456789","accountNumber":"1234567890"}}],"metadata":{"internalRef":"2345"}}]},"pricing":{"type":"intent","pricingIntentId":6123},"signature":"requestedViaDirectLink","contacts":[{"type":"manager","firstName":"Jane","middleName":"Helen","lastName":"Doe","identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}]}],"metadata":{"customerId":"2345"}}'
application/json
{"processingAccountId": "12345","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "entered","doingBusinessAs": "Pizza Doe","owners": [{"ownerId": 4564,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/owners/4564","method": "get"}}],"website": "www.example.com","businessType": "restaurant","categoryCode": 5999,"merchandiseOrServiceSold": "Pizza","businessStartDate": "2020-01-01","timezone": "America/Chicago","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "email",}],"processing": {"transactionAmounts": {"average": 5000,"highest": 10000},"monthlyAmounts": {"average": 50000,"highest": 100000},"volumeBreakdown": {"cardPresentKeyed": 47,"cardPresentSwiped": 30,"mailOrTelephone": 3,"ecommerce": 20},"isSeasonal": true,"monthsOfOperation": ["jan","feb"],"ach": {"naics": "44-45","previouslyTerminatedForAch": false,"refunds": {"writtenRefundPolicy": true,"refundPolicyUrl": "www.example.com/refund-poilcy-url"},"estimatedMonthlyTransactions": 3000,"limits": {"singleTransaction": 10000,"dailyDeposit": 200000,"monthlyDeposit": 6000000},"transactionTypes": ["prearrangedPayment","other"],"transactionTypesOther": "anotherTransactionType"},"cardAcceptance": {"debitOnly": false,"cardsAccepted": ["visa","mastercard"],"specialityCards": {"americanExpressDirect": {"enabled": true,"merchantNumber": "abc1234567"},"electronicBenefitsTransfer": {"enabled": true,"fnsNumber": "abc1234"},"other": {"wexMerchantNumber": "abc1234567","voyagerMerchantId": "abc1234567","fleetMerchantId": "abc1234567"}}}},"funding": {"status": "enabled","fundingSchedule": "nextday","acceleratedFundingFee": 1999,"dailyDiscount": false,"fundingAccounts": [{"fundingAccountId": 123,"status": "pending","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-account/123"}}]},"pricing": {"link": {"rel": "pricing","href": "https://api.payroc.com/v1/processing-account/12345/pricing","method": "get"}},"contacts": [{"contactId": 1543,"firstName": "Jane","lastName": "Doe","link": {"rel": "contact","href": "https://api.payroc.com/v1/contacts/1543","method": "get"}}],"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000000","method": "get"}},"metadata": {"customerId": "2345"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Funding accounts limit reached | Funding accounts restricted. You can not have any more than two funding accounts attached to this entity |
Too many control prongs | Your request included more than one owner as the control prong. You can set only one owner as the control prong. |
No control prong or authorized signatory | Your request didn’t indicate which owner is the control prong or the authorized signatory. Set one owner as the control prong or the authorized signatory. |
Cannot select Daily Discount and RewardPay or RewardPayChoice at the same time. | You can't select Daily Discount with a RewardPay or RewardPayChoice pricing plan. To select Daily Discount, choose a different pricing plan. |
Not Authorized | Your identity could not be verified |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/owners/4564 \--header 'Authorization: Bearer <access token>'
application/json
{"ownerId": 4564,"firstName": "Jane","middleName": "Helen","lastName": "Doe","dateOfBirth": "1964-03-22","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "email",}],"relationship": {"equityPercentage": 35.4,"title": "CFO","isControlProng": true,"isAuthorizedSignatory": false}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request put \--url https://api.payroc.com/v1/owners/4564 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"firstName":"Jane","middleName":"Helen","lastName":"Doe","dateOfBirth":"1964-03-22","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"identifiers":[{"type":"nationalId","value":"000-00-4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}],"relationship":{"equityPercentage":35.4,"title":"CFO","isControlProng":true,"isAuthorizedSignatory":false}}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request delete \--url https://api.payroc.com/v1/owners/4564 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/pricing-intents \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 1,"count": 1,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/pricing-intents?before=5&limit=1"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/pricing-intents?after=5&limit=1"}],"data": [{"id": "5","createdDate": "2020-09-22T09:00:00","lastUpdatedDate": "2020-09-22T09:00:00","status": "pendingReview","key": "base","country": "US","version": "4.0","base": {"addressVerification": 5,"annualFee": {"billInMonth": "december","amount": 100},"regulatoryAssistanceProgram": 15,"pciNonCompliance": 4995,"merchantAdvantage": 10,"platinumSecurity": {"billingFrequency": "monthly","amount": 1295},"maintenance": 500,"minimum": 100,"voiceAuthorization": 95,"chargeback": 2500,"retrieval": 1500,"batch": 1000,"earlyTermination": 57500},"processor": {"card": {"planType": "interchangePlus","fees": {"mastercardVisaDiscover": {"volume": 1.25,"transaction": 5},"amex": {"type": "optBlue","volume": 1.25,"transaction": 10},"pinDebit": {"additionalDiscount": 1.25,"transaction": 10,"monthlyAccess": 1200},"electronicBenefitsTransfer": {"transaction": 10},"enhancedInterchange": {"enrollment": 1000,"creditToMerchant": 5.25},"specialityCards": {"transaction": 10}}},"ach": {"fees": {"transaction": 50,"batch": 1000,"returns": 400,"unauthorizedReturn": 1999,"statement": 800,"monthlyMinimum": 20000,"accountVerification": 100,"discountRateUnder10000": 5.25,"discountRateAbove10000": 10}}},"gateway": {"fees": {"monthly": 1000,"setup": 25000,"perTransaction": 0,"perDeviceMonthly": 0,"additionalServiceMonthly": 0}}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/pricing-intents \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"key":"Your-Unique-Identifier","metadata":{"internalReference":"2345"},"country":"US","version":"4.0","base":{"addressVerification":5,"annualFee":{"billInMonth":"june","amount":100},"regulatoryAssistanceProgram":15,"pciNonCompliance":4995,"merchantAdvantage":10,"platinumSecurity":{"billingFrequency":"monthly"},"maintenance":500,"minimum":100,"voiceAuthorization":95,"chargeback":2500,"retrieval":1500,"batch":1500,"earlyTermination":57500},"processor":{"card":{"planType":"interchangePlus","fees":{"mastercardVisaDiscover":{"volume":1.25,"transaction":5},"amex":{"type":"optBlue","volume":1.25,"transaction":5},"pinDebit":{"additionalDiscount":1.25,"transaction":10,"monthlyAccess":1200},"electronicBenefitsTransfer":{"transaction":10},"enhancedInterchange":{"enrollment":1000,"creditToMerchant":5.25},"specialityCards":{"transaction":10}}},"ach":{"fees":{"transaction":50,"batch":1000,"returns":400,"unauthorizedReturn":1999,"statement":800,"monthlyMinimum":20000,"accountVerification":100,"discountRateUnder10000":5.25,"discountRateAbove10000":10}}},"gateway":{"fees":{"monthly":2000,"setup":5000,"perTransaction":2000,"perDeviceMonthly":10,"additionalServiceMonthly":10}}}'
application/json
{"id": "5","createdDate": "2020-09-22T09:00:00","lastUpdatedDate": "2020-09-22T09:00:00","status": "pendingReview","key": "string","metadata": {"internalReference": "2345"},"country": "US","version": "4.0","base": {"addressVerification": 5,"annualFee": {"billInMonth": "december","amount": 100},"regulatoryAssistanceProgram": 15,"pciNonCompliance": 4995,"merchantAdvantage": 10,"platinumSecurity": {"billingFrequency": "monthly","amount": 1295},"maintenance": 500,"minimum": 100,"voiceAuthorization": 95,"chargeback": 2500,"retrieval": 1500,"batch": 1000,"earlyTermination": 57500},"processor": {"card": {"planType": "interchangePlus","fees": {"mastercardVisaDiscover": {"volume": 1.25,"transaction": 5},"amex": {"type": "optBlue","volume": 1.25,"transaction": 10},"pinDebit": {"additionalDiscount": 1.25,"transaction": 10,"monthlyAccess": 1200},"electronicBenefitsTransfer": {"transaction": 10},"enhancedInterchange": {"enrollment": 1000,"creditToMerchant": 5.25},"specialityCards": {"transaction": 10}}},"ach": {"fees": {"transaction": 50,"batch": 1000,"returns": 400,"unauthorizedReturn": 1999,"statement": 800,"monthlyMinimum": 20000,"accountVerification": 100,"discountRateUnder10000": 5.25,"discountRateAbove10000": 10}}},"gateway": {"fees": {"monthly": 1000,"setup": 25000,"perTransaction": 0,"perDeviceMonthly": 0,"additionalServiceMonthly": 0}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/pricing-intents/5 \--header 'Authorization: Bearer <access token>'
application/json
{"id": "5","createdDate": "2020-09-22T09:00:00","lastUpdatedDate": "2020-09-22T09:00:00","status": "pendingReview","key": "string","metadata": {"internalReference": "2345"},"country": "US","version": "4.0","base": {"addressVerification": 5,"annualFee": {"billInMonth": "december","amount": 100},"regulatoryAssistanceProgram": 15,"pciNonCompliance": 4995,"merchantAdvantage": 10,"platinumSecurity": {"billingFrequency": "monthly","amount": 1295},"maintenance": 500,"minimum": 100,"voiceAuthorization": 95,"chargeback": 2500,"retrieval": 1500,"batch": 1000,"earlyTermination": 57500},"processor": {"card": {"planType": "interchangePlus","fees": {"mastercardVisaDiscover": {"volume": 1.25,"transaction": 5},"amex": {"type": "optBlue","volume": 1.25,"transaction": 10},"pinDebit": {"additionalDiscount": 1.25,"transaction": 10,"monthlyAccess": 1200},"electronicBenefitsTransfer": {"transaction": 10},"enhancedInterchange": {"enrollment": 1000,"creditToMerchant": 5.25},"specialityCards": {"transaction": 10}}},"ach": {"fees": {"transaction": 50,"batch": 1000,"returns": 400,"unauthorizedReturn": 1999,"statement": 800,"monthlyMinimum": 20000,"accountVerification": 100,"discountRateUnder10000": 5.25,"discountRateAbove10000": 10}}},"gateway": {"fees": {"monthly": 1000,"setup": 25000,"perTransaction": 0,"perDeviceMonthly": 0,"additionalServiceMonthly": 0}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request put \--url https://api.payroc.com/v1/pricing-intents/5 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"key":"Your-Unique-Identifier","metadata":{"internalReference":"2345"},"country":"US","version":"4.0","base":{"addressVerification":5,"annualFee":{"billInMonth":"june","amount":100},"regulatoryAssistanceProgram":15,"pciNonCompliance":4995,"merchantAdvantage":10,"platinumSecurity":{"billingFrequency":"monthly"},"maintenance":500,"minimum":100,"voiceAuthorization":95,"chargeback":2500,"retrieval":1500,"batch":1500,"earlyTermination":57500},"processor":{"card":{"planType":"interchangePlus","fees":{"mastercardVisaDiscover":{"volume":1.25,"transaction":5},"amex":{"type":"optBlue","volume":1.25,"transaction":5},"pinDebit":{"additionalDiscount":1.25,"transaction":10,"monthlyAccess":1200},"electronicBenefitsTransfer":{"transaction":10},"enhancedInterchange":{"enrollment":1000,"creditToMerchant":5.25},"specialityCards":{"transaction":10}}},"ach":{"fees":{"transaction":50,"batch":1000,"returns":400,"unauthorizedReturn":1999,"statement":800,"monthlyMinimum":20000,"accountVerification":100,"discountRateUnder10000":5.25,"discountRateAbove10000":10}}},"gateway":{"fees":{"monthly":2000,"setup":5000,"perTransaction":2000,"perDeviceMonthly":10,"additionalServiceMonthly":10}}}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
PATCH /pricing-intents/{pricingIntentId}Partially update an existing pricing intent. Structure your request to follow the RFC 6902 standard.
curl --request patch \--url https://api.payroc.com/v1/pricing-intents/5 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '[{"op":"replace","path":"/processor/card/fees/mastercardVisaDiscover/volume","value":1.5},{"op":"replace","path":"/gateway/fees/additionalServiceMonthly","value":16},{"op":"replace","path":"/base/addressVerification","value":6}]'
application/json
{"id": "5","createdDate": "2020-09-22T09:00:00","lastUpdatedDate": "2020-09-22T09:00:00","status": "pendingReview","key": "string","metadata": {"internalReference": "2345"},"country": "US","version": "4.0","base": {"addressVerification": 5,"annualFee": {"billInMonth": "december","amount": 100},"regulatoryAssistanceProgram": 15,"pciNonCompliance": 4995,"merchantAdvantage": 10,"platinumSecurity": {"billingFrequency": "monthly","amount": 1295},"maintenance": 500,"minimum": 100,"voiceAuthorization": 95,"chargeback": 2500,"retrieval": 1500,"batch": 1000,"earlyTermination": 57500},"processor": {"card": {"planType": "interchangePlus","fees": {"mastercardVisaDiscover": {"volume": 1.25,"transaction": 5},"amex": {"type": "optBlue","volume": 1.25,"transaction": 10},"pinDebit": {"additionalDiscount": 1.25,"transaction": 10,"monthlyAccess": 1200},"electronicBenefitsTransfer": {"transaction": 10},"enhancedInterchange": {"enrollment": 1000,"creditToMerchant": 5.25},"specialityCards": {"transaction": 10}}},"ach": {"fees": {"transaction": 50,"batch": 1000,"returns": 400,"unauthorizedReturn": 1999,"statement": 800,"monthlyMinimum": 20000,"accountVerification": 100,"discountRateUnder10000": 5.25,"discountRateAbove10000": 10}}},"gateway": {"fees": {"monthly": 1000,"setup": 25000,"perTransaction": 0,"perDeviceMonthly": 0,"additionalServiceMonthly": 0}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request delete \--url https://api.payroc.com/v1/pricing-intents/5 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
GET /processing-accounts/{processingAccountId}Retrieve a specific processing account.
curl --request get \--url https://api.payroc.com/v1/processing-accounts/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"processingAccountId": "38765","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","doingBusinessAs": "Pizza Doe","owners": [{"ownerId": 4564,"firstName": "Jane","lastName": "Doe","link": {"rel": "owner","href": "https://api.payroc.com/v1/owners/1543","method": "get"}}],"website": "www.example.com","businessType": "restaurant","categoryCode": 5999,"merchandiseOrServiceSold": "Pizza","businessStartDate": "2020-01-01","timezone": "America/Chicago","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "email",}],"processing": {"merchantId": "444412365478965","transactionAmounts": {"average": 5000,"highest": 10000},"monthlyAmounts": {"average": 50000,"highest": 100000},"volumeBreakdown": {"cardPresentKeyed": 47,"cardPresentSwiped": 30,"mailOrTelephone": 3,"ecommerce": 20},"isSeasonal": true,"monthsOfOperation": ["jan","feb"],"ach": {"naics": "44-45","previouslyTerminatedForAch": false,"refunds": {"writtenRefundPolicy": true,"refundPolicyUrl": "www.example.com/refund-poilcy-url"},"estimatedMonthlyTransactions": 3000,"limits": {"singleTransaction": 10000,"dailyDeposit": 200000,"monthlyDeposit": 6000000},"transactionTypes": ["prearrangedPayment","other"],"transactionTypesOther": "anotherTransactionType"},"cardAcceptance": {"debitOnly": false,"cardsAccepted": ["visa","mastercard"],"specialityCards": {"americanExpressDirect": {"enabled": true,"merchantNumber": "abc1234567"},"electronicBenefitsTransfer": {"enabled": true,"fnsNumber": "abc1234"},"other": {"wexMerchantNumber": "abc1234567","voyagerMerchantId": "abc1234567","fleetMerchantId": "abc1234567"}}}},"funding": {"status": "enabled","fundingSchedule": "nextday","acceleratedFundingFee": 1999,"dailyDiscount": false,"fundingAccounts": [{"fundingAccountId": 123,"status": "pending","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-account/123"}}]},"pricing": {"link": {"rel": "pricing","href": "https://api.payroc.com/v1/processing-account/38765/pricing","method": "get"}},"contacts": [{"contactId": 1543,"firstName": "Jane","lastName": "Doe","link": {"rel": "contact","href": "https://api.payroc.com/v1/contacts/1543","method": "get"}}],"signature": {"type": "requestedViaDirectLink","link": {"rel": "agreement","href": "https://us.agreementexpress.net/mv2/viewer2.jsp?docId=00000000-0000-0000-0000-000000000000","method": "get"}},"metadata": {"customerId": "2345"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-accounts/{processingAccountId}/funding-accountsRetrieve a list of funding accounts associated with a processing account.
curl --request get \--url https://api.payroc.com/v1/processing-accounts/abc123/funding-accounts \--header 'Authorization: Bearer <access token>'
application/json
[{"fundingAccountId": 123,"createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","type": "checking","use": "creditAndDebit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****6789","accountNumber": "******7890"}}],"metadata": {"internalRef": "2345"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/processing-accounts/38765","method": "get"}]},{"fundingAccountId": 124,"createdDate": "2021-01-08T12:00:00.000Z","lastModifiedDate": "2021-01-08T12:00:00.000Z","status": "pending","type": "checking","use": "creditAndDebit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****8725","accountNumber": "******3491"}}],"metadata": {"internalRef": "2346"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/processing-accounts/38765","method": "get"}]}]
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-accounts/{processingAccountId}/contactsRetrieve a list of contacts associated with a processing account.
curl --request get \--url https://api.payroc.com/v1/processing-accounts/abc123/contacts \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/processing-accounts/38765/contacts?before=4564&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/processing-accounts/38765/contacts?after=4565&limit=2"}],"data": [{"contactId": 1543,"type": "manager","firstName": "Jane","middleName": "Helen","lastName": "Doe","identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "phone","value": "2025550164"},{"type": "mobile","value": "8445557624"},{"type": "email",}]},{"contactId": 12346,"type": "representative","firstName": "Fred","middleName": "Jim","lastName": "Nerk","identifiers": [{"type": "nationalId","value": "xxxxx9876"}],"contactMethods": [{"type": "phone","value": "2025550110"},{"type": "mobile","value": "85645787451"},{"type": "email",}]}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-accounts/{processingAccountId}/pricingRetrieve a pricing agreement for a processing account.
curl --request get \--url https://api.payroc.com/v1/processing-accounts/abc123/pricing \--header 'Authorization: Bearer <access token>'
application/json
{"country": "US","version": "4.0","base": {"addressVerification": 5,"annualFee": {"billInMonth": "june","amount": 100},"regulatoryAssistanceProgram": 15,"pciNonCompliance": 4995,"merchantAdvantage": 10,"platinumSecurity": {"billingFrequency": "monthly","amount": 1295},"maintenance": 500,"minimum": 100,"voiceAuthorization": 95,"chargeback": 2500,"retrieval": 1500,"batch": 1500,"earlyTermination": 57500},"processor": {"card": {"planType": "interchangePlus","fees": {"mastercardVisaDiscover": {"volume": 1.25,"transaction": 0},"amex": {"type": "optBlue","volume": 1.25,"transaction": 0},"pinDebit": {"additionalDiscount": 1.25,"transaction": 0,"monthlyAccess": 0},"electronicBenefitsTransfer": {"transaction": 0},"enhancedInterchange": {"enrollment": 0,"creditToMerchant": 1.25},"specialityCards": {"transaction": 0}}},"ach": {"fees": {"transaction": 50,"batch": 1000,"returns": 400,"unauthorizedReturn": 1999,"statement": 800,"monthlyMinimum": 20000,"accountVerification": 100,"discountRateUnder10000": 1.25,"discountRateAbove10000": 1.25}}},"gateway": {"fees": {"monthly": 0,"setup": 0,"perTransaction": 0,"perDeviceMonthly": 0,"additionalServiceMonthly": 0}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-accounts/{processingAccountId}/ownersRetrieve owners associated with a processing account.
curl --request get \--url https://api.payroc.com/v1/processing-accounts/abc123/owners \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/processing-accounts/38765/owners?before=4564&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/processing-accounts/38765/owners?after=4565&limit=2"}],"data": [{"ownerId": 4564,"firstName": "Jane","middleName": "Helen","lastName": "Doe","dateOfBirth": "1964-03-22","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "email",},{"type": "phone","value": "2025550164"}],"relationship": {"equityPercentage": 49,"title": "CFO","isControlProng": true,"isAuthorizedSignatory": false}},{"ownerId": 12346,"firstName": "Fred","middleName": "Jim","lastName": "Nerk","dateOfBirth": "1980-01-19","address": {"address1": "2 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"identifiers": [{"type": "nationalId","value": "xxxxx9876"}],"contactMethods": [{"type": "email",}],"relationship": {"equityPercentage": 51,"title": "CEO","isControlProng": false,"isAuthorizedSignatory": true}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
POST /processing-accounts/{processingAccountId}/remindersWhen you create a processing account, we send a copy of the pricing agreement to the merchant to sign. You can choose to send them a copy of the pricing agreement by email, or you can generate a link to the pricing agreement.
curl --request post \--url https://api.payroc.com/v1/processing-accounts/abc123/reminders \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"type":"pricingAgreement"}'
application/json
{"reminderId": "1234567","type": "pricingAgreement"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not requested by email | We couldn't resend the email to the merchant because you didn't originally choose to send the information by email. |
Contract already signed | We couldn’t resend the email because the merchant already signed the contract. |
No pricing agreement exists for the processing account | We couldn’t resend the email because there is no pricing agreement for the processing account. |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
GET /funding-accountsRetrieve a list of all funding accounts associated with the ISV.
curl --request get \--url https://api.payroc.com/v1/funding-accounts \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/funding-accounts?before=123&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/funding-accounts?after=124&limit=2"}],"data": [{"fundingAccountId": 123,"createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","type": "checking","use": "credit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****6789","accountNumber": "******7890"}}],"metadata": {"internalRef": "2345"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/merchants/1234","method": "get"}]},{"fundingAccountId": 124,"createdDate": "2021-01-08T12:00:00.000Z","lastModifiedDate": "2021-01-08T12:00:00.000Z","status": "pending","type": "checking","use": "debit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****8725","accountNumber": "******3491"}}],"metadata": {"internalRef": "2346"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/funding-recipient/2","method": "get"}]}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
GET /funding-accounts/{fundingAccountId}Retrieve a specific funding account.
curl --request get \--url https://api.payroc.com/v1/funding-accounts/89 \--header 'Authorization: Bearer <access token>'
application/json
{"fundingAccountId": 123,"createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "pending","type": "checking","use": "credit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****6789","accountNumber": "******7890"}}],"metadata": {"internalRef": "2345"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/merchants/1234","method": "get"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request put \--url https://api.payroc.com/v1/funding-accounts/89 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"type":"checking","use":"credit","nameOnAccount":"Jane Doe","paymentMethods":[{"type":"ach","value":{"routingNumber":"123456789","accountNumber":"1234567890"}}],"metadata":{"internalRef":"2345"}}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request delete \--url https://api.payroc.com/v1/funding-accounts/89 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
GET /funding-balanceRetrieve the balance of funds that are available for each merchant.
curl --request get \--url https://api.payroc.com/v1/funding-balance \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/funding-balance?before=65&limit=2"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/funding-balance?after=66&limit=2"}],"data": [{"merchantId": "65","funds": 120000,"pending": 50050,"available": 69950,"currency": "USD"},{"merchantId": "66","funds": 50000,"pending": 0,"available": 50000,"currency": "USD"}]}
Error | Description |
---|---|
Bad request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/funding-activity?dateFrom=2022-10-01&dateTo=2022-10-01' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 10,"count": 10,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/funding-activity?before=11&limit=10&datefrom=2021-01-01&dateto=2021-01-30"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/funding-activity?after=20&limit=10&datefrom=2021-01-01&dateto=2021-01-30"}],"data": [{"id": "11","date": "2021-01-01T17:00:00.000Z","merchant": "Doe Hot Dogs","description": "sales","type": "credit","amount": 20000,"currency": "USD"},{"id": "12","date": "2021-01-01T19:32:00.000Z","merchant": "Doe Hot Dogs","description": "sales","type": "credit","amount": 50000,"currency": "USD"},{"id": "13","date": "2021-01-01T17:00:00.000Z","merchant": "Doe Hot Dogs","recipient": "Doe Hot Dogs","description": "payment","type": "debit","amount": 10000,"currency": "USD"},{"id": "14","date": "2021-01-01T17:00:00.000Z","merchant": "Doe Hot Dogs","recipient": "Payroc","description": "Interchange Fees","type": "debit","amount": 500,"currency": "USD"},{"id": "15","date": "2021-01-03T09:10:00.000Z","merchant": "Doe Hot Dogs","description": "sales","type": "credit","amount": 30000,"currency": "USD"},{"id": "16","date": "2021-01-10T17:00:00.000Z","merchant": "Janes shoe laces LTD","description": "adjustment","type": "credit","amount": 500,"currency": "USD"},{"id": "17","date": "2021-01-10T17:00:00.000Z","merchant": "Janes shoe laces LTD","recipient": "Payroc","description": "Interchange Fees","type": "debit","amount": 500,"currency": "USD"},{"id": "18","date": "2021-01-15T17:00:00.000Z","merchant": "Doe Hot Dogs","recipient": "Payroc","description": "Charge back","type": "debit","amount": 1000,"currency": "USD"},{"id": "19","date": "2021-01-17T17:00:00.000Z","merchant": "Janes shoe laces LTD","description": "sales","type": "credit","amount": 50000,"currency": "USD"},{"id": "20","date": "2021-01-26T17:00:00.000Z","merchant": "Doe Hot Dogs","recipient": "Mr Payfac corp","description": "payment","type": "debit","amount": 5000,"currency": "USD"}]}
Error | Description |
---|---|
Bad request | One or more validation errors occurred. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
POST /funding-instructionsCreate funding instructions to tell us how to divide funds between your funding recipients.
curl --request post \--url https://api.payroc.com/v1/funding-instructions \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"merchants":[{"merchantId":"123456","recipients":[{"fundingAccountId":5432425374,"paymentMethod":"ACH","amount":{"value":12350,"currency":"USD"},"metadata":{"customerId":"2345"}}]}],"metadata":{"internalInstructionRef":"abcdef"}}'
application/json
{"instructionId": 123,"createdDate": "2021-09-05T13:15:00.000Z","lastModifiedDate": null,"status": "accepted","merchants": [{"merchantId": "99999","recipients": [{"status": "accepted","fundingAccountId": 67890,"paymentMethod": "ACH","amount": {"value": 12350,"currency": "USD"},"metadata": {"customerId": "2345"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/67890"}}],"link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/99999"}}],"metadata": {"instructionRef": "abcd"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Insufficient funds | You do not have enough funds to complete the request. |
Idempotency key missing | Idempotency key must be supplied |
Funding accounts restricted | Funding accounts restricted. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
GET /funding-instructionsRetrieve a list of funding instructions for a specific date range.
curl --request get \--url 'https://api.payroc.com/v1/funding-instructions?dateFrom=2022-10-01&dateTo=2022-10-01' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/funding-instructions?before=65&limit=2&datefrom=2021-01-01&dateto=2021-01-30"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/funding-instructions?after=66&limit=2&datefrom=2021-01-01&dateto=2021-01-30"}],"data": [{"instructionId": 65,"createdDate": "2021-09-05T13:15:00.000Z","lastModifiedDate": "2021-09-06T18:00:00.000Z","status": "completed","merchants": [{"merchantId": "99999","recipients": [{"status": "funded","fundingAccountId": 67890,"paymentMethod": "ACH","amount": {"value": 12350,"currency": "USD"},"metadata": {"customerId": "2345"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/67890"}},{"status": "rejected","fundingAccountId": 67889,"paymentMethod": "ACH","amount": {"value": 9000,"currency": "USD"},"metadata": {"customerId": "2345"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/67889"}}],"link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/99999"}}],"metadata": {"instrcutionRef": "abcd"},"link": {"rel": "fundingInstruction","method": "get","href": "https://api.payroc.com/v1/funding-instructions/65"}},{"instructionId": 66,"createdDate": "2021-09-06T13:15:00.000Z","lastModifiedDate": null,"status": "accepted","merchants": [{"merchantId": "12345","recipients": [{"status": "accepted","fundingAccountId": 54784,"paymentMethod": "ACH","amount": {"value": 5000,"currency": "USD"},"metadata": {"customerId": "5412"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/54784"}}],"link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/12345"}},{"merchantId": 12346,"recipients": [{"status": "accepted","fundingAccountId": 54784,"paymentMethod": "ACH","amount": {"value": 1000,"currency": "USD"},"metadata": {"customerId": "5412"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/54784"}}],"link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/12346"}}],"metadata": {"instrcutionRef": "efgh"},"link": {"rel": "fundingInstruction","method": "get","href": "https://api.payroc.com/v1/funding-instructions/66"}}]}
Error | Description |
---|---|
Bad request | One or more validation errors occurred. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /funding-instructions/{instructionId}Retrieve a specific funding instruction.
curl --request get \--url https://api.payroc.com/v1/funding-instructions/89 \--header 'Authorization: Bearer <access token>'
application/json
{"instructionId": 12345,"createdDate": "2021-09-05T13:15:00.000Z","lastModifiedDate": "2021-09-06T18:00:00.000Z","status": "accepted","merchants": [{"merchantId": "123456","recipients": [{"fundingAccountId": 5432425374,"paymentMethod": "ACH","amount": {"value": 12350,"currency": "USD"},"status": "accepted","metadata": {"customerId": "2345"},"link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/5432425374"}}],"link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/123456"}}],"metadata": {"internalInstructionRef": "abcdef"}}
Error | Description |
---|---|
Bad request | One or more validation errors occurred. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
PUT /funding-instructions/{instructionId}Update an existing funding instruction.
curl --request put \--url https://api.payroc.com/v1/funding-instructions/89 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"merchants":[{"merchantId":"123456","recipients":[{"fundingAccountId":5432425374,"paymentMethod":"ACH","amount":{"value":12350,"currency":"USD"},"metadata":{"customerId":"2345"}}]}],"metadata":{"internalInstructionRef":"abcdef"}}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Insufficient funds | You do not have enough funds to complete the request. |
Cannot be modified | Resource cannot be modified. |
Bad request | One or more validation errors occurred. |
Funding accounts restricted | Funding accounts restricted. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
DELETE /funding-instructions/{instructionId}Delete an existing funding instruction.
curl --request delete \--url https://api.payroc.com/v1/funding-instructions/89 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Cannot be modified | Resource cannot be modified. |
Bad request | One or more validation errors occurred. |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/funding-recipients \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"recipientType":"privateCorporation","taxId":"123456789","charityId":"abc123","doingBusinessAs":"abc123","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"contactMethods":[{"type":"email","value":"[email protected]"}],"metadata":{"customerId":"2345"},"owners":[{"firstName":"Jane","middleName":"Helen","lastName":"Doe","dateOfBirth":"1964-03-22","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"identifiers":[{"type":"nationalId","value":"xxxxx4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}],"relationship":{"equityPercentage":35.4,"title":"CFO","isControlProng":true,"isAuthorizedSignatory":false}}],"fundingAccounts":[{"type":"checking","use":"credit","nameOnAccount":"Jane Doe","paymentMethods":[{"type":"ach","value":{"routingNumber":"123456789","accountNumber":"1234567890"}}],"metadata":{"internalRef":"2345"}}]}'
application/json
{"recipientId": 1,"status": "approved","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","recipientType": "privateCorporation","taxId": "123456789","charityId": "abc123","doingBuinessAs": "abc123","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "email",}],"metadata": {"customerId": "2345"},"owners": [{"ownerId": 4564,"link": {"rel": "owner","href": "https://api.payroc.com/v1/owners/4564","method": "get"}}],"fundingAccounts": [{"fundingAccountId": 1,"status": "approved","link": {"rel": "fundingAccount","href": "https://api.payroc.com/v1/funding-accounts/1","method": "get"}},{"fundingAccountId": 2,"status": "rejected","link": {"rel": "fundingAccount","href": "https://api.payroc.com/v1/funding-accounts/2","method": "get"}}]}
Error | Description |
---|---|
Idempotency key missing | Idempotency key must be supplied |
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
GET /funding-recipientsRetrieve a list of all funding recipients associated with the ISV.
curl --request get \--url https://api.payroc.com/v1/funding-recipients \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 10,"count": 1,"hasMore": false,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/funding-recipients?before=12345&limit=10"}],"data": [{"recipientId": 12345,"status": "approved","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","recipientType": "privateCorporation","taxId": "123456789","doingBuinessAs": "Example llc","address": {"address1": "1 Example Ave.","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "phone","value": "123 456 7890"}],"metadata": {"customerId": "12345"},"owners": [{"ownerId": 4564,"link": {"rel": "owner","method": "get","href": "https://api.payroc.com/v1/owners/4564"}}],"fundingAccounts": [{"fundingAccountId": 1,"status": "approved","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/1"}},{"fundingAccountId": 2,"status": "hold","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/2"}}]}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Api error | Unable to process your request. |
GET /funding-recipients/{recipientId}Retrieve a specific funding recipient.
curl --request get \--url https://api.payroc.com/v1/funding-recipients/89 \--header 'Authorization: Bearer <access token>'
application/json
{"recipientId": 12345,"status": "approved","createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","recipientType": "privateCorporation","taxId": "123456789","doingBuinessAs": "Example llc","address": {"address1": "1 Example Ave.","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"contactMethods": [{"type": "phone","value": "123 456 7890"}],"metadata": {"customerId": "12345"},"owners": [{"ownerId": 4564,"link": {"rel": "owner","method": "get","href": "https://api.payroc.com/v1/owners/4564"}}],"fundingAccounts": [{"fundingAccountId": 1,"status": "approved","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/1"}},{"fundingAccountId": 2,"status": "hold","link": {"rel": "fundingAccount","method": "get","href": "https://api.payroc.com/v1/funding-accounts/2"}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
PUT /funding-recipients/{recipientId}Update a funding recipient. If you make significant changes, we may need to approve the funding recipient again.
curl --request put \--url https://api.payroc.com/v1/funding-recipients/89 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"recipientType":"privateCorporation","taxId":"123456789","charityId":"abc123","doingBuinessAs":"abc123","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"contactMethods":[{"type":"email","value":"[email protected]"}],"metadata":{"customerId":"2345"}}'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
DELETE /funding-recipients/{recipientId}Delete a funding recipient. This includes funding accounts and owners linked to the funding recipient.
curl --request delete \--url https://api.payroc.com/v1/funding-recipients/89 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
GET /funding-recipients/{recipientId}/funding-accountsRetrieve all funding accounts associated with the funding recipient.
curl --request get \--url https://api.payroc.com/v1/funding-recipients/89/funding-accounts \--header 'Authorization: Bearer <access token>'
application/json
[{"fundingAccountId": 123,"createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","type": "checking","use": "credit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****6789","accountNumber": "******7890"}}],"metadata": {"internalRef": "2345"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/funding-recipient/2","method": "get"}]},{"fundingAccountId": 124,"createdDate": "2021-01-08T12:00:00.000Z","lastModifiedDate": "2021-01-08T12:00:00.000Z","status": "pending","type": "checking","use": "debit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****8725","accountNumber": "******3491"}}],"metadata": {"internalRef": "2346"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/funding-recipient/2","method": "get"}]}]
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
POST /funding-recipients/{recipientId}/funding-accountsCreate a new funding account, and add it to the funding recipient.
curl --request post \--url https://api.payroc.com/v1/funding-recipients/89/funding-accounts \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"type":"checking","use":"credit","nameOnAccount":"Jane Doe","paymentMethods":[{"type":"ach","value":{"routingNumber":"123456789","accountNumber":"1234567890"}}],"metadata":{"internalRef":"2345"}}'
application/json
{"fundingAccountId": 123,"createdDate": "2020-09-08T12:00:00.000Z","lastModifiedDate": "2020-09-08T12:00:00.000Z","status": "approved","type": "checking","use": "credit","nameOnAccount": "Jane Doe","paymentMethods": [{"type": "ach","value": {"routingNumber": "*****6789","accountNumber": "******7890"}}],"metadata": {"internalRef": "2345"},"links": [{"rel": "parent","href": "https://api.payroc.com/v1/funding-recipient/2","method": "get"}]}
Error | Description |
---|---|
Idempotency key missing | Idempotency key must be supplied |
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
GET /funding-recipients/{recipientId}/ownersRetrieve all owners associated with the funding recipient.
curl --request get \--url https://api.payroc.com/v1/funding-recipients/89/owners \--header 'Authorization: Bearer <access token>'
application/json
[{"ownerId": 4564,"firstName": "Jane","middleName": "Helen","lastName": "Doe","dateOfBirth": "1964-03-22","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "email",}],"relationship": {"equityPercentage": 35.4,"title": "CFO","isControlProng": true,"isAuthorizedSignatory": false}}]
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
POST /funding-recipients/{recipientId}/ownersCreate a new owner, and add it to the funding recipient.
curl --request post \--url https://api.payroc.com/v1/funding-recipients/89/owners \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"firstName":"Jane","middleName":"Helen","lastName":"Doe","dateOfBirth":"1964-03-22","address":{"address1":"1 Example Ave.","address2":"Example Address Line 2","address3":"Example Address Line 3","city":"Chicago","state":"Illinois","country":"US","postalCode":"60056"},"identifiers":[{"type":"nationalId","value":"xxxxx4320"}],"contactMethods":[{"type":"email","value":"[email protected]"}],"relationship":{"equityPercentage":35.4,"title":"CFO","isControlProng":true,"isAuthorizedSignatory":false}}'
application/json
{"ownerId": 4564,"firstName": "Jane","middleName": "Helen","lastName": "Doe","dateOfBirth": "1964-03-22","address": {"address1": "1 Example Ave.","address2": "Example Address Line 2","address3": "Example Address Line 3","city": "Chicago","state": "Illinois","country": "US","postalCode": "60056"},"identifiers": [{"type": "nationalId","value": "xxxxx4320"}],"contactMethods": [{"type": "email",}],"relationship": {"equityPercentage": 35.4,"title": "CFO","isControlProng": true,"isAuthorizedSignatory": false}}
Error | Description |
---|---|
Idempotency key missing | Idempotency key must be supplied |
Bad Request | One or more validation errors occurred |
KYC check failed | KYC check failed |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Idempotency key in use | Idempotency key in use |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/bank-accounts/verify \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"processingTerminalId":"1017","bankAccount":{"type":"pad","accountType":"checking","nameOnAccount":"Joe Bloggs","accountNumber":"12345678909","routingNumber":"123456789","transitNumber":"12345","institutionNumber":"123"}}'
application/json
{"processingTerminalId": "1017","verified": true}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/bank-transfer-payments \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"processingTerminalId":"1017","order":{"orderId":"orderpop123","description":"sample order","amount":11110,"currency":"USD","breakdown":{"subtotal":10000,"tip":{"type":"percentage","percentage":10},"taxes":[{"name":"VAT","rate":1}]}},"customer":{"notificationLanguage":"en","contactMethods":[{"type":"email","value":"[email protected]"}]},"credentialOnFile":{"tokenize":true},"paymentMethod":{"type":"ach","accountType":"checking","nameOnAccount":"Joe Bloggs","accountNumber":"11101010","routingNumber":"053200983","secCode":"web"}}'
application/json
{"paymentId": "M2MJOG6O2Y","processingTerminalId": "1017","order": {"orderId": "orderpop123","dateTime": "2023-07-25T14:08:45.179+01:00","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"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
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-16T11:53:18-04:00","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-16T11:52:56-04:00","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"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
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-25T14:08:45.179+01:00","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"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/bank-transfer-payments/abc123/reverse \--header 'Authorization: Bearer <access token>' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324'
application/json
{"paymentId": "JKNIJXNZAK","processingTerminalId": "1017","order": {"orderId": "157","dateTime": "2023-05-16T11:54:43-04:00","description": "sample order","amount": 12100,"currency": "CAD","breakdown": {"subtotal": 10000,"tip": {"type": "percentage","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": "reversal","authorizedAmount": 12100,"currency": "CAD","responseCode": "A"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
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: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"amount":10000,"description":"amount to refund"}'
application/json
{"paymentId": "M12F8SUHGM","processingTerminalId": "1017","order": {"orderId": "243","dateTime": "2023-07-25T22:57:11+01:00","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"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /bank-transfer-payments/{paymentId}/representRe-present a customer's bank account details if the first payment was declined.
curl --request post \--url https://api.payroc.com/v1/bank-transfer-payments/abc123/represent \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"paymentMethod":{"type":"ach","accountType":"checking","nameOnAccount":"Joe Bloggs","accountNumber":"49100130","routingNumber":"292735277","secCode":"TEL"}}'
application/json
{"paymentId": "M2MJOG6O2Y","processingTerminalId": "1017","order": {"orderId": "orderpop123","dateTime": "2023-07-25T14:08:45.179+01:00","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"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /bank-transfer-refundsSend a refund to a customer's bank account. The refund transaction is not linked to the previous transaction.
curl --request post \--url https://api.payroc.com/v1/bank-transfer-refunds \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"processingTerminalId":"1017","order":{"orderId":314,"description":"refund example","amount":1000,"currency":"USD"},"customer":{"notificationLanguage":"en","contactMethods":[{"type":"email","value":"[email protected]"}]},"refundMethod":{"type":"ach","secCode":"web","accountType":"checking","nameOnAccount":"Joe Bloggs","accountNumber":"32183159","routingNumber":"063100277"}}'
application/json
{"refundId": "JH58KQ5K5E","processingTerminalId": "1017","order": {"orderId": "314","dateTime": "2023-05-17T09:24:11.693-04:00","description": "refund example","amount": 50000,"currency": "USD"},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****3159","routingNumber": "*****0277"},"transactionResult": {"type": "unreferencedRefund","status": "ready","authorizedAmount": -50000,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/bank-transfer-refunds?processingTerminalId=abc123' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"refundId": "DYDJ5KHRT4","processingTerminalId": "1017","order": {"orderId": "304","dateTime": "2023-05-17T09:23:41-04:00","description": "refund example","amount": 100000,"currency": "USD"},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****3159","routingNumber": "*****0277"},"transactionResult": {"type": "unreferencedRefund","status": "ready","authorizedAmount": -100000,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}},{"refundId": "B6ZOFZNVOP","processingTerminalId": "1017","order": {"orderId": "355","dateTime": "2023-05-17T09:21:30-04:00","description": "refund example","amount": 12000,"currency": "USD"},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****3159","routingNumber": "*****0277"},"transactionResult": {"type": "unreferencedRefund","status": "ready","authorizedAmount": -12000,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/bank-transfer-refunds?limit=2&processingTerminalId=1017&after=B6ZOFZNVOP"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/bank-transfer-refunds?processingTerminalId=1017&limit=2&before=DYDJ5KHRT4"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/bank-transfer-refunds/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"refundId": "JH58KQ5K5E","processingTerminalId": "1017","order": {"orderId": "314","dateTime": "2023-05-17T09:24:11.693-04:00","description": "refund example","amount": 50000,"currency": "USD"},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****3159","routingNumber": "*****0277"},"transactionResult": {"type": "unreferencedRefund","status": "ready","authorizedAmount": -50000,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/bank-transfer-refunds/abc123/reverse \--header 'Authorization: Bearer <access token>' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324'
application/json
{"refundId": "B5FK0CBP2D","processingTerminalId": "1017","order": {"orderId": "622","dateTime": "2023-05-17T09:54:51-04:00","description": "refund example","amount": 1000,"currency": "USD"},"customer": {"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"bankAccount": {"type": "ach","secCode": "web","accountType": "checking","nameOnAccount": "Joe Bloggs","accountNumber": "****3159","routingNumber": "*****0277"},"transactionResult": {"type": "unreferencedRefund","status": "reversal","authorizedAmount": -1000,"currency": "USD","responseCode": "A","responseMessage": "NoError","processorResponseCode": "0"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /cards/verifyVerify that a card is valid. For banks that do not support verification, we charge a micro deposit that we void immediately.
curl --request post \--url https://api.payroc.com/v1/cards/verify \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"Mark Simpsons","processingTerminalId":"1001","card":{"type":"card","cardDetails":{"entryMethod":"keyed","cardholderName":"Joe Bloggs","cardholderSignature":"13ab","keyedData":{"dataFormat":"plainText","cardNumber":"4539858876047062","expiryDate":"1230"}}}}'
application/json
{"operator": "Mark Simpsons","processingTerminalId": "1001","card": {"type": "Visa Credit","entryMethod": "keyed","cardholderName": "Joe Bloggs","cardholderSignature": "13ab","cardNumber": "453985******7062","expiryDate": "1230"},"verified": true,"transactionResult": {"status": "ready","responseCode": "A","responseMessage": "APPROVAL"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/cards/balance \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"operator":"Mark Simpsons","processingTerminalId":"1024","currency":"USD","card":{"type":"card","cardDetails":{"entryMethod":"keyed","cardholderName":"Joe Bloggs","cardholderSignature":"12ab","keyedData":{"dataFormat":"plainText","cardNumber":"6007602801003837967","expiryDate":"1229","device":{"type":"PAX_A920_PRO","dataKsn":"FFFF5B09910001000061","firmwareVersion":"PayDroid_8.1.0_Sagittarius_V11.1.11_20200904 V1.04.02_20210617","category":"attended","serialNumber":"1850010868"}},"pinDetails":{"dataFormat":"dukpt","pin":"0123456789abcdef","pinKsn":"0002152304aad1234561"},"ebtDetails":{"benefitCategory":"cash"}}}}'
application/json
{"operator": "Mark Simpsons","processingTerminalId": "1024","card": {"type": "Common Benefit Identification Card","entryMethod": "keyed","cardholderName": "Joe Bloggs","cardholderSignature": "12ab","cardNumber": "600760*********7967","expiryDate": "1229","balances": [{"benefitCategory": "cash","amount": 10000,"currency": "USD"}]},"responseCode": "A","responseMessage": "Approved"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /cards/bin-lookupPerform a BIN (Bank Identification Number) lookup to retrieve information about a card.
curl --request post \--url https://api.payroc.com/v1/cards/bin-lookup \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"operator":"Andrew White","processingTerminalId":"1005","card":{"type":"card","cardDetails":{"entryMethod":"keyed","cardholderName":"Joe Bloggs","cardholderSignature":"13ab","keyedData":{"dataFormat":"plainText","cardNumber":"5001650000000000","expiryDate":"1225"}}}}'
application/json
{"type": "MASTERCARD","cardNumber": "500165******0000","country": "US","currency": "USD","debit": false}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /fx-ratesCheck if a customer’s card is eligible for Dynamic Currency Conversion (DCC). If the card is eligible for DCC, offer currency conversion to the customer during a transaction.
curl --request post \--url https://api.payroc.com/v1/fx-rates \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--data '{"channel":"web","operator":"Aaron","processingTerminalId":"1005","baseAmount":10000,"baseCurrency":"EUR","paymentMethod":{"type":"card","accountType":"checking","cardDetails":{"entryMethod":"keyed","cardholderName":"Joe Bloggs","keyedData":{"dataFormat":"plainText","cardNumber":"5001650000000000","expiryDate":"0430"}}}}'
application/json
{"processingTerminalId": "1005","operator": "Aaron","baseAmount": 10000,"baseCurrency": "EUR","inquiryResult": {"dccOffered": true},"dccOffer": {"accepted": true,"reference": "3396977e-40b9-4b26-8a3f-c25bc1280ee2","fxAmount": 13612,"fxCurrency": "JPY","fxCurrencyCode": "392","fxCurrencyExponent": 0,"fxRate": 136.1248,"markup": 3,"provider": "FEXCO","source": "REUTERS WHOLESALE INTERBANK"},"cardInfo": {"type": "MASTERCARD","cardNumber": "500165******0000"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/payment-plansCreate a new payment plan.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/payment-plans \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"paymentPlanId":"1001_yearly_plan","name":"1001 yearly payment plan","description":"1001 yearly payment plan","currency":"EUR","setupOrder":{"amount":1010,"description":"payment plan setup order","breakdown":{"subtotal":1000,"taxes":[{"name":"VAT","rate":1}]}},"recurringOrder":{"amount":1010,"description":"payment plan setup order","breakdown":{"subtotal":1000,"taxes":[{"name":"VAT","rate":1}]}},"length":5,"type":"automatic","frequency":"yearly","onUpdate":"continue","onDelete":"complete"}'
application/json
{"paymentPlanId": "1001_yearly_plan","processingTerminalId": "1001","name": "1001 yearly payment plan","description": "1001 yearly payment plan","currency": "EUR","setupOrder": {"amount": 1010,"description": "payment plan setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "payment plan recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"length": 5,"type": "automatic","frequency": "yearly","onUpdate": "continue","onDelete": "complete"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/payment-plansRetrieve a list of payment plans.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/payment-plans \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"paymentPlanId": "1001_yearly_plan","processingTerminalId": "1001","name": "1001 yearly plan","description": "payment plan, setup order with taxes","currency": "EUR","length": 0,"type": "automatic","frequency": "yearly","onUpdate": "continue","onDelete": "complete"},{"paymentPlanId": "1001_payment_plan_premium","processingTerminalId": "1001","name": "1001 payment plan premium","description": "a template payment plan for premium users","currency": "EUR","length": 0,"type": "automatic","frequency": "yearly","onUpdate": "continue","onDelete": "complete"}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans?limit=2&after=M4MY49Z5JB"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans?limit=2&before=GKB49GZ6DL"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/payment-plans/{paymentPlanId}Retrieve a specific payment plan.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/payment-plans/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"paymentPlanId": "1001_yearly_plan","processingTerminalId": "1001","name": "1001 yearly payment plan","description": "1001 yearly payment plan","currency": "EUR","setupOrder": {"amount": 1010,"description": "payment plan setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "payment plan recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"length": 5,"type": "automatic","frequency": "yearly","onUpdate": "continue","onDelete": "complete"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
PATCH /processing-terminals/{processingTerminalId}/payment-plans/{paymentPlanId}Make changes to an existing payment plan. Structure your request to follow the RFC 6902 standard.
curl --request patch \--url https://api.payroc.com/v1/processing-terminals/abc123/payment-plans/abc123 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '[{"op":"add","path":"/a/b/c","value":["dog","cat"]},{"op":"remove","path":"/a/b/c"},{"op":"replace","path":"/a/b/c","value":42},{"op":"move","from":"/a/b/c","path":"/a/b/d"},{"op":"copy","from":"/a/b/d","path":"/a/b/e"},{"op":"test","path":"/a/b/c","value":"dog"}]'
application/json
{"paymentPlanId": "1001_yearly_plan","processingTerminalId": "1001","name": "1001 yearly payment plan","description": "1001 yearly payment plan","currency": "EUR","setupOrder": {"amount": 1010,"description": "payment plan setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "payment plan recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"length": 5,"type": "automatic","frequency": "yearly","onUpdate": "continue","onDelete": "complete"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
DELETE /processing-terminals/{processingTerminalId}/payment-plans/{paymentPlanId}Delete an existing payment plan.
curl --request delete \--url https://api.payroc.com/v1/processing-terminals/abc123/payment-plans/abc123 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
POST /paymentsRun a sale or pre-authorization. You can also:
curl --request post \--url https://api.payroc.com/v1/payments \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"channel":"web","processingTerminalId":"1023","operator":"Postman","order":{"orderId":"order123","description":"Example payment","currency":"USD","amount":100},"customer":{"firstName":"Robert","lastName":"Red","billingAddress":{"address1":"billing address1","address2":"billing address2","address3":"billing address3","city":"Los Angeles","state":"California","country":"US","postalCode":90005},"shippingAddress":{"recipientName":"shipping recipientName","address":{"address1":"shipping address1","address2":"shipping address2","address3":"shipping address3","city":"San Diego","state":"California","country":"US","postalCode":91911}}},"paymentMethod":{"type":"card","cardDetails":{"entryMethod":"keyed","keyedData":{"dataFormat":"plainText","device":{"model":"paxA80","serialNumber":"WPC202833004712"},"expiryDate":"0328","cardNumber":"5001650000000000"}}}}'
application/json
{"paymentId": "KP77BIWR96","processingTerminalId": "1023","operator": "Postman","order": {"orderId": "order123","dateTime": "2023-07-26T17:42:25.018+01:00","description": "Example payment","amount": 100,"currency": "USD"},"customer": {"firstName": "Robert","lastName": "Red","billingAddress": {"address1": "billing address","address2": "billing address2","address3": "billing address3","city": "Los Angeles","state": "California","country": "US","postalCode": "90005"},"shippingAddress": {"recipientName": "shipping recipientName","address": {"address1": "shipping address1","address2": "shipping address2","address3": "shipping address3","city": "San Diego","state": "California","country": "US","postalCode": "91911"}}},"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": "ready","approvalCode": "OK3","authorizedAmount": 100,"currency": "USD","responseCode": "A","responseMessage": "OK3"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
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-16T17:45:29+01:00","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-16T17:45:28+01:00","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"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/payments/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"paymentId": "KP77BIWR96","processingTerminalId": "1023","operator": "Postman","order": {"orderId": "order123","dateTime": "2023-07-26T17:42:25.018+01:00","description": "Example payment","amount": 100,"currency": "USD"},"customer": {"firstName": "Robert","lastName": "Red","billingAddress": {"address1": "billing address","address2": "billing address2","address3": "billing address3","city": "Los Angeles","state": "California","country": "US","postalCode": "90005"},"shippingAddress": {"recipientName": "shipping recipientName","address": {"address1": "shipping address1","address2": "shipping address2","address3": "shipping address3","city": "San Diego","state": "California","country": "US","postalCode": "91911"}}},"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": "ready","approvalCode": "OK3","authorizedAmount": 100,"currency": "USD","responseCode": "A","responseMessage": "OK3"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/payments/abc123/adjust \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"adjustments":[{"type":"customer","shippingAddress":{"recipientName":"new recipientName","address":{"address1":"new address1","address2":"address2","address3":"address3","city":"Miami","state":"Florida","country":"US","postalCode":33101}}},{"type":"order","amount":1000}]}'
application/json
{"paymentId": "HW986AQOBB","processingTerminalId": "1023","order": {"orderId": "6u6","dateTime": "2023-07-27T10:28:44+01:00","description": "Example payment","amount": 1000,"currency": "USD"},"customer": {"firstName": "Robert","lastName": "Red","billingAddress": {"address1": "billing address","address2": "billing address2","address3": "billing address3","city": "Los Angeles","state": "California","country": "US","postalCode": "90005"},"shippingAddress": {"recipientName": "new recipientName","address": {"address1": "new address1","address2": "address2","address3": "address3","city": "Miami","state": "Florida","country": "US","postalCode": "33101"}}},"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": "ready","approvalCode": "OK6","authorizedAmount": 1000,"currency": "USD","responseCode": "A","responseMessage": "OK6"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/payments/abc123/capture \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"processingTerminalId":"abc123","operator":"abc123","amount":89,"breakdown":{"subtotal":89,"cashbackAmount":89,"tip":{"type":"percentage","amount":0,"percentage":0},"taxes":[{"name":"abc123","rate":0}],"surcharge":{"bypass":false},"dualPricing":{"offered":false,"alternativeTender":"card"},"dutyAmount":89,"freightAmount":89,"items":[{"commodityCode":"abc123","productCode":"abc123","description":"abc123","unitOfMeasure":"ACR","unitPrice":0,"quantity":0,"discountRate":0,"taxes":[{"name":"abc123","rate":0}]}]}}'
application/json
{"paymentId": "KP77BIWR96","processingTerminalId": "1023","operator": "Postman","order": {"orderId": "order123","dateTime": "2023-07-26T17:42:25.018+01:00","description": "Example payment","amount": 100,"currency": "USD"},"customer": {"firstName": "Robert","lastName": "Red","billingAddress": {"address1": "billing address","address2": "billing address2","address3": "billing address3","city": "Los Angeles","state": "California","country": "US","postalCode": "90005"},"shippingAddress": {"recipientName": "shipping recipientName","address": {"address1": "shipping address1","address2": "shipping address2","address3": "shipping address3","city": "San Diego","state": "California","country": "US","postalCode": "91911"}}},"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": "ready","approvalCode": "OK3","authorizedAmount": 100,"currency": "USD","responseCode": "A","responseMessage": "OK3"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
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: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"amount":10}'
application/json
{"paymentId": "FRED4RL3GO","processingTerminalId": "1023","order": {"orderId": "MAPI_V2_PAY_23","dateTime": "2023-05-18T10:29:25+01:00","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"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/payments/abc123/refund \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"amount":100,"description":"refund - defective item"}'
application/json
{"paymentId": "JTWWI49L6U","processingTerminalId": "1023","operator": "Adam Smith","order": {"orderId": "86f","dateTime": "2024-01-16T16:57:18Z","description": "Example payment","amount": 100,"currency": "USD"},"customer": {"firstName": "Robert","lastName": "Red","billingAddress": {"address1": "billing address","address2": "billing address2","address3": "billing address3","city": "Los Angeles","state": "California","country": "US","postalCode": "90005"},"shippingAddress": {"recipientName": "shipping recipientName","address": {"address1": "shipping address1","address2": "shipping address2","address3": "shipping address3","city": "San Diego","state": "California","country": "US","postalCode": "91911"}}},"card": {"type": "MasterCard","entryMethod": "keyed","cardNumber": "500165******0000","expiryDate": "0328","securityChecks": {"cvvResult": "M","avsResult": "Y"}},"refunds": [{"refundId": "BI77XQFQ05","dateTime": "2024-01-16T17:00:41Z","amount": -60,"currency": "USD","status": "ready","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/refunds/BI77XQFQ05"}}],"supportedOperations": ["refund"],"transactionResult": {"type": "sale","status": "complete","approvalCode": "OK13","authorizedAmount": 100,"currency": "USD","responseCode": "A","responseMessage": "OK13"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/refunds \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"processingTerminalId":"1023","order":{"orderId":"1023_refund_oa8","description":"refund example","amount":1000,"currency":"USD"},"channel":"web","refundMethod":{"type":"card","cardDetails":{"entryMethod":"keyed","keyedData":{"dataFormat":"plainText","device":{"type":"DATECS_BLUEPAD50","serialNumber":"WPC202833004712"},"expiryDate":"0328","cardNumber":"5001650000000000"}}}}'
application/json
{"refundId": "CD3HN88U9F","processingTerminalId": "1023","order": {"orderId": "1023_refund_oa8","dateTime": "2023-07-27T09:51:02.91+01:00","description": "refund example","amount": 1000,"currency": "USD"},"card": {"type": "MasterCard","entryMethod": "keyed","cardNumber": "500165******0000","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "ready","approvalCode": "000000","authorizedAmount": -1000,"currency": "USD","responseCode": "A","responseMessage": "OK5"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/refunds \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"refundId": "FPU8P48WN8","processingTerminalId": "1001","order": {"orderId": "1001_refund_1","dateTime": "2023-05-18T16:32:47+01:00","description": "refund example","amount": 1000,"currency": "EUR"},"card": {"type": "MasterCard","cardNumber": "500165******0000","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "ready","approvalCode": "000000","authorizedAmount": -1000,"currency": "EUR","responseCode": "A","responseMessage": "APPROVAL"}},{"refundId": "CYGDZJF0MH","processingTerminalId": "1001","order": {"orderId": "1001_refund","dateTime": "2023-05-18T16:22:43+01:00","description": "refund example","amount": 1000,"currency": "EUR"},"card": {"type": "MasterCard","cardNumber": "500165******0000","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "reversal","approvalCode": "000000","authorizedAmount": -1000,"currency": "EUR","responseCode": "A","responseMessage": "APPROVAL"}}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/refunds?processingTerminalId=1001&limit=2&after=CYGDZJF0MH"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/refunds?processingTerminalId=1001&limit=2&before=FPU8P48WN8"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/refunds/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"refundId": "CD3HN88U9F","processingTerminalId": "1023","order": {"orderId": "1023_refund_oa8","dateTime": "2023-07-27T09:51:02.91+01:00","description": "refund example","amount": 1000,"currency": "USD"},"card": {"type": "MasterCard","entryMethod": "keyed","cardNumber": "500165******0000","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "ready","approvalCode": "000000","authorizedAmount": -1000,"currency": "USD","responseCode": "A","responseMessage": "OK5"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/refunds/abc123/adjust \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"Adam Smith","adjustments":[{"type":"customer","contactMethods":[{"type":"mobile","value":"+14155556666"}]}]}'
application/json
{"refundId": "I2HLYTVB81","processingTerminalId": "1023","operator": "Adam Smith","order": {"orderId": "1023_refund_czz","dateTime": "2023-07-28T09:44:35+01:00","description": "refund example","amount": 1000,"currency": "USD"},"customer": {"contactMethods": [{"type": "mobile","value": "+14155556666"}]},"card": {"type": "MasterCard","entryMethod": "keyed","cardNumber": "500165******0000","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "ready","approvalCode": "000000","authorizedAmount": -1000,"currency": "USD","responseCode": "A","responseMessage": "OK13"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
curl --request post \--url https://api.payroc.com/v1/refunds/abc123/reverse \--header 'Authorization: Bearer <access token>' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324'
application/json
{"refundId": "IH83EP2SRN","processingTerminalId": "1001","order": {"orderId": "1001_refund_2","dateTime": "2023-05-18T16:33:10+01:00","description": "refund example","amount": 1000,"currency": "EUR"},"card": {"type": "Visa Credit","entryMethod": "keyed","cardNumber": "453985******7062","expiryDate": "0328"},"transactionResult": {"type": "refund","status": "reversal","approvalCode": "000000","authorizedAmount": -1000,"currency": "EUR","responseCode": "A","responseMessage": "APPROVAL"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/secure-tokensSave the customer's payment details to use in future transactions.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/secure-tokens \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"Adam Smith","mitAgreement":"unscheduled","customer":{"firstName":"Jessica","lastName":"Red","dateOfBirth":"1990-01-01","referenceNumber":"Customer-12","billingAddress":{"address1":"Example Street","address2":"Example address2","address3":"Example address3","city":"Fresno","state":"California","country":"US","postalCode":93650},"shippingAddress":{"recipientName":"Example shipping recipientName","address":{"address1":"Example shipping street","address2":"Example shipping address2","address3":"Exampleshipping address3","city":"Austin","state":"Texas","country":"US","postalCode":73301}},"contactMethods":[{"type":"email","value":"[email protected]"}],"notificationLanguage":"en"},"ipAddress":{"type":"ipv4","value":"124.201.101.1"},"source":{"type":"card","cardDetails":{"entryMethod":"keyed","cardholderName":"Joe Bloggs","keyedData":{"dataFormat":"plainText","cardNumber":"4001020000000009","expiryDate":"0825","cvv":"713"}}}}'
application/json
{"secureTokenId": "MREF_fce7bf52-b3b4-4270-aee9-77b938595078Hm","processingTerminalId": "1001","mitAgreement": "unscheduled","customer": {"firstName": "Joe","lastName": "Bloggs","dateOfBirth": "1950-01-01","referenceNumber": "Customer-1","billingAddress": {"address1": "Example Street","address2": "Example address2","address3": "Example address3","city": "Example Town","state": "California","country": "US","postalCode": "1234"},"shippingAddress": {"recipientName": "Example shipping recipientName","address": {"address1": "Example shipping street","address2": "Example shipping address2","address3": "Exampleshipping address3","city": "Example shipping city","state": "Texas","country": "US","postalCode": "1"}},"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"source": {"type": "card","cardholderName": "Joe Bloggs","cardNumber": "400102******0009","expiryDate": "0825"},"token": "2967532489076298","status": "notValidated"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/secure-tokensReturn a list of secure tokens that are currently saved on the terminal.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/secure-tokens \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"secureTokenId": "MREF_bd8abfe6-77ed-4e3b-be9f-91cb2f8801daJ2","processingTerminalId": "1001","mitAgreement": "unscheduled","customer": {"firstName": "Joe","lastName": "Bloggs","dateOfBirth": "1950-01-01","referenceNumber": "Customer-1","billingAddress": {"address1": "Example Street","address2": "Example address2","address3": "Example address3","city": "Example Town","state": "California","country": "US","postalCode": "1234"},"shippingAddress": {"recipientName": "Example shipping recipientName","address": {"address1": "Example shipping street","address2": "Example shipping address2","address3": "Exampleshipping address3","city": "Example shipping city","state": "Texas","country": "US","postalCode": "1"}}},"source": {"type": "card","cardholderName": "Joe Bloggs","cardNumber": "500165******0000","expiryDate": "0825"},"token": "2967539621698111","status": "notValidated"},{"secureTokenId": "MREF_dd8d2205-dae2-482c-b89a-2fc14513d7b7l7","processingTerminalId": "1001","mitAgreement": "unscheduled","customer": {"firstName": "Joe","lastName": "Bloggs","dateOfBirth": "1990-01-01","referenceNumber": "Customer-12","billingAddress": {"address1": "Example Street","address2": "Example address2","address3": "Example address3","city": "Example Town","state": "California","country": "US","postalCode": "1234"},"shippingAddress": {"recipientName": "Example shipping recipientName","address": {"address1": "Example shipping street","address2": "Example shipping address2","address3": "Exampleshipping address3","city": "Example shipping city","state": "Texas","country": "US","postalCode": "1"}}},"source": {"type": "card","cardholderName": "Joe Bloggs","cardNumber": "400006******0006","expiryDate": "0825"},"token": "2967530499662487","status": "notValidated"}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens?limit=2&after=KLOLSOAKSL"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens?limit=2&before=HUAR33GOO6"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/secure-tokens/{secureTokenId}Return a secure token and its related payment details.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/secure-tokens/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"secureTokenId": "MREF_fce7bf52-b3b4-4270-aee9-77b938595078Hm","processingTerminalId": "1001","mitAgreement": "unscheduled","customer": {"firstName": "Joe","lastName": "Bloggs","dateOfBirth": "1950-01-01","referenceNumber": "Customer-1","billingAddress": {"address1": "Example Street","address2": "Example address2","address3": "Example address3","city": "Example Town","state": "California","country": "US","postalCode": "1234"},"shippingAddress": {"recipientName": "Example shipping recipientName","address": {"address1": "Example shipping street","address2": "Example shipping address2","address3": "Exampleshipping address3","city": "Example shipping city","state": "Texas","country": "US","postalCode": "1"}},"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"source": {"type": "card","cardholderName": "Joe Bloggs","cardNumber": "400102******0009","expiryDate": "0825"},"token": "2967532489076298","status": "notValidated"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
PATCH /processing-terminals/{processingTerminalId}/secure-tokens/{secureTokenId}Update the customer's payment details that are represented by the secure token. Structure your request to follow the RFC 6902 standard.
curl --request patch \--url https://api.payroc.com/v1/processing-terminals/abc123/secure-tokens/abc123 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '[{"op":"add","path":"/a/b/c","value":["dog","cat"]},{"op":"remove","path":"/a/b/c"},{"op":"replace","path":"/a/b/c","value":42},{"op":"move","from":"/a/b/c","path":"/a/b/d"},{"op":"copy","from":"/a/b/d","path":"/a/b/e"},{"op":"test","path":"/a/b/c","value":"dog"}]'
application/json
{"secureTokenId": "MREF_fce7bf52-b3b4-4270-aee9-77b938595078Hm","processingTerminalId": "1001","mitAgreement": "unscheduled","customer": {"firstName": "Joe","lastName": "Bloggs","dateOfBirth": "1950-01-01","referenceNumber": "Customer-1","billingAddress": {"address1": "Example Street","address2": "Example address2","address3": "Example address3","city": "Example Town","state": "California","country": "US","postalCode": "1234"},"shippingAddress": {"recipientName": "Example shipping recipientName","address": {"address1": "Example shipping street","address2": "Example shipping address2","address3": "Exampleshipping address3","city": "Example shipping city","state": "Texas","country": "US","postalCode": "1"}},"contactMethods": [{"type": "email",}],"notificationLanguage": "en"},"source": {"type": "card","cardholderName": "Joe Bloggs","cardNumber": "400102******0009","expiryDate": "0825"},"token": "2967532489076298","status": "notValidated"}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
DELETE /processing-terminals/{processingTerminalId}/secure-tokens/{secureTokenId}Delete a secure token and its represented payment details.
curl --request delete \--url https://api.payroc.com/v1/processing-terminals/abc123/secure-tokens/abc123 \--header 'Authorization: Bearer <access token>'
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/subscriptionsCreate a new subscription.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"subscriptionId":"11001_subscription_cinema","paymentPlanId":"1001_payment_plan_yearly","paymentMethod":{"type":"secureToken","token":"2967533500670317"},"name":"subscription from postman","description":"created through postman for card token","setupOrder":{"amount":1010,"description":"setup order","breakdown":{"subtotal":1000,"taxes":[{"name":"VAT","rate":1}]},"orderId":"setup order"},"recurringOrder":{"amount":1010,"description":"recurring order","breakdown":{"subtotal":1000,"taxes":[{"name":"VAT","rate":1}]}},"startDate":"2023-07-01","endDate":"2025-07-01","length":2,"pauseCollectionFor":0}'
application/json
{"subscriptionId": "1001_subscription_cinema","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1001_paymentplan_yearly","name": "yearly payment plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1001_paymentplan_yearly"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "avant-garde","description": "avant-garde cinema subscription","currency": "EUR","setupOrder": {"orderId": "setup-order","amount": 1010,"description": "setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"currentState": {"status": "active","nextDueDate": "2023-04-25","paidInvoices": 0,"outstandingInvoices": 3},"startDate": "2023-04-25","endDate": "2025-04-25","length": 24,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/subscriptionsList subscriptions linked to a terminal.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"data": [{"subscriptionId": "subscription 6","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "5","name": "platinum plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/5"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "subscription 6","description": "this is description","currency": "EUR","setupOrder": {"orderId": "order 201","amount": 1010,"description": "payment plan setup order"},"recurringOrder": {"amount": 100},"currentState": {"status": "active","nextDueDate": "2024-04-11","paidInvoices": 1,"outstandingInvoices": 10},"startDate": "2023-04-11","endDate": "2033-04-11","length": 0,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0},{"subscriptionId": "subscripion 5","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1","name": "gold plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "subscription 5","description": "some description","currency": "EUR","setupOrder": {"orderId": "order-509","amount": 1010},"recurringOrder": {"amount": 100},"currentState": {"status": "active","nextDueDate": "2024-04-11","paidInvoices": 1,"outstandingInvoices": 10},"startDate": "2023-04-11","endDate": "2033-04-11","length": 0,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}],"links": [{"rel": "next","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/subscriptions?limit=2&after=LN3K88F1UH"},{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/processing-terminals/1001/subscriptions?limit=2&before=DBDVNUL6RG"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /processing-terminals/{processingTerminalId}/subscriptions/{subscriptionId}Retrieve a specific subscription.
curl --request get \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"subscriptionId": "1001_subscription_cinema","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1001_paymentplan_yearly","name": "yearly payment plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1001_paymentplan_yearly"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "avant-garde","description": "avant-garde cinema subscription","currency": "EUR","setupOrder": {"orderId": "setup-order","amount": 1010,"description": "setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"currentState": {"status": "active","nextDueDate": "2023-04-25","paidInvoices": 0,"outstandingInvoices": 3},"startDate": "2023-04-25","endDate": "2025-04-25","length": 24,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
PATCH /processing-terminals/{processingTerminalId}/subscriptions/{subscriptionId}Make changes to a subscription. Structure your request to follow the RFC 6902 standard.
curl --request patch \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions/abc123 \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '[{"op":"add","path":"/a/b/c","value":["dog","cat"]},{"op":"remove","path":"/a/b/c"},{"op":"replace","path":"/a/b/c","value":42},{"op":"move","from":"/a/b/c","path":"/a/b/d"},{"op":"copy","from":"/a/b/d","path":"/a/b/e"},{"op":"test","path":"/a/b/c","value":"dog"}]'
application/json
{"subscriptionId": "1001_subscription_cinema","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1001_paymentplan_yearly","name": "yearly payment plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1001_paymentplan_yearly"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "avant-garde","description": "avant-garde cinema subscription","currency": "EUR","setupOrder": {"orderId": "setup-order","amount": 1010,"description": "setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"currentState": {"status": "active","nextDueDate": "2023-04-25","paidInvoices": 0,"outstandingInvoices": 3},"startDate": "2023-04-25","endDate": "2025-04-25","length": 24,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/subscriptions/{subscriptionId}/deactivateDeactivate a subscription.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions/abc123/deactivate \--header 'Authorization: Bearer <access token>'
application/problem+json
{"subscriptionId": "1001_subscription_cinema","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1001_paymentplan_yearly","name": "yearly payment plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1001_paymentplan_yearly"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "avant-garde","description": "avant-garde cinema subscription","currency": "EUR","setupOrder": {"orderId": "setup-order","amount": 1010,"description": "setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"currentState": {"status": "cancelled","nextDueDate": "2023-04-25","paidInvoices": 0,"outstandingInvoices": 3},"startDate": "2023-04-25","endDate": "2025-04-25","length": 24,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/subscriptions/{subscriptionId}/reactivateRe-activate an existing subscription.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions/abc123/reactivate \--header 'Authorization: Bearer <access token>'
application/json
{"subscriptionId": "1001_subscription_cinema","processingTerminalId": "1001","paymentPlan": {"paymentPlanId": "1001_paymentplan_yearly","name": "yearly payment plan","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/payment-plans/1001_paymentplan_yearly"}},"secureToken": {"secureTokenId": "SecureCard1001","customerName": "Joe Bloggs","token": "2967533500670317","status": "notValidated","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/processing-terminals/1001/secure-tokens/SecureCard1001"}},"name": "avant-garde","description": "avant-garde cinema subscription","currency": "EUR","setupOrder": {"orderId": "setup-order","amount": 1010,"description": "setup order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"recurringOrder": {"amount": 1010,"description": "recurring order","breakdown": {"subtotal": 1000,"taxes": [{"name": "VAT","rate": 1}]}},"currentState": {"status": "active","nextDueDate": "2023-04-25","paidInvoices": 0,"outstandingInvoices": 3},"startDate": "2023-04-25","endDate": "2025-04-25","length": 24,"type": "automatic","frequency": "yearly","pauseCollectionFor": 0}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /processing-terminals/{processingTerminalId}/subscriptions/{subscriptionId}/payProcess payment for a manual subscription.
curl --request post \--url https://api.payroc.com/v1/processing-terminals/abc123/subscriptions/abc123/pay \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"Giuseppe Green","order":{"amount":1010,"description":"manual payment","breakdown":{"subtotal":1000,"taxes":[{"name":"VAT","rate":1}]},"orderId":"manual payment orderx12s"}}'
application/json
{"subscriptionId": "1017_subscription_metro","processingTerminalId": "1017","payment": {"paymentId": "GTZH5WVXK9","dateTime": "2023-07-27T23:36:03.506+01:00","amount": 1010,"currency": "CAD","status": "ready","responseCode": "A","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/bank-transfer-payments/GTZH5WVXK9"}},"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"}},"currentState": {"status": "active","nextDueDate": "2024-07-01","paidInvoices": 1,"outstandingInvoices": 2}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Idempotency key in use | Idempotency key in use |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
POST /devices/{serialNumber}/payment-instructionsSubmit an instruction request to initiate a sale on a payment device.
curl --request post \--url https://api.payroc.com/v1/devices/abc123/payment-instructions \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"jbloggs","processingTerminalId":"1021","order":{"orderId":"4fd4-99bc","currency":"USD","amount":1000},"customizationOptions":{"entryMethod":"deviceRead"},"autoCapture":true}'
application/json
{"paymentInstructionId": "3743a9165d134678a9100ebba3b29597","status": "inProgress","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/payment-instructions/3743a9165d134678a9100ebba3b29597"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
GET /payment-instructions/{paymentInstructionId}Retrieve the current status of a specific payment instruction.
curl --request get \--url https://api.payroc.com/v1/payment-instructions/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"paymentInstructionId": "3743a9165d134678a9100ebba3b29597","status": "completed","link": {"rel": "payment","method": "GET","href": "https://api.payroc.com/v1/payments/DD6ZDQU7L2"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
POST /devices/{serialNumber}/refund-instructionsSubmit an instruction request to initiate a refund on a payment device.
curl --request post \--url https://api.payroc.com/v1/devices/abc123/refund-instructions \--header 'Authorization: Bearer <access token>' \--header 'Content-Type: application/json' \--header 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \--data '{"operator":"jbloggs","processingTerminalId":"1021","order":{"orderId":"4fd4-99bc","currency":"USD","amount":1000},"customizationOptions":{"entryMethod":"manualEntry"}}'
application/json
{"refundInstructionId": "3743a9165d134678a9100ebba3b29597","status": "inProgress","link": {"rel": "self","method": "GET","href": "https://api.payroc.com/v1/refund-instructions/3743a9165d134678a9100ebba3b29597"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Idempotency key missing | Idempotency key must be supplied |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Resource already exists | Resource already exists |
Unsupported media type | The payload is in an unsupported format. |
Api error | Unable to process your request. |
GET /refund-instructions/{refundInstructionId}Retrieve the current status of a specific refund instruction.
curl --request get \--url https://api.payroc.com/v1/refund-instructions/abc123 \--header 'Authorization: Bearer <access token>'
application/json
{"refundInstructionId": "3743a9165d134678a9100ebba3b29597","status": "completed","link": {"rel": "refund","method": "GET","href": "https://api.payroc.com/v1/refunds/DD6ZDQU7L2"}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/batches?date=2021-09-05' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 2,"hasMore": true,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/batches?before=65&limit=2&date=2021-01-01"},{"rel": "next","method": "get","href": "https://api.payroc.com/v1/batches?after=66&limit=2&&date=2021-01-01"}],"data": [{"batchId": 65,"date": "2021-01-01","createdDate": "2021-09-05","lastModifiedDate": "2021-09-06","saleAmount": 100,"heldAmount": 0,"returnAmount": 0,"transactionCount": 10,"currency": "USD","merchant": {"merchantId": "4525644354","doingBusinessAs": "Pizza Doe","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"links": [{"rel": "transactions","method": "get","href": "https://api.payroc.com/v1/transactions?batchId=65"},{"rel": "authorizations","method": "get","href": "https://api.payroc.com/v1/authorizations?batchId=65"}]},{"batchId": 66,"date": "2021-01-01","createdDate": "2021-09-05","lastModifiedDate": "2021-09-06","saleAmount": 76,"heldAmount": 0,"returnAmount": 12,"transactionCount": 10,"currency": "USD","merchant": {"merchantId": "987654321","doingBusinessAs": "Joe Bloggs Shoes","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/987654321"}},"links": [{"rel": "transactions","method": "get","href": "https://api.payroc.com/v1/transactions?batchId=66"},{"rel": "authorizations","method": "get","href": "https://api.payroc.com/v1/authorizations?batchId=66"}]}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/batches/12345 \--header 'Authorization: Bearer <access token>'
application/json
{"batchId": 123,"date": "2021-09-05","createdDate": "2024-01-30","lastModifiedDate": "2024-01-30","saleAmount": 89,"heldAmount": 89,"returnAmount": 89,"transactionCount": 89,"currency": "abc123","merchant": {"merchantId": "4525644354","doingBusinessAs": "Doe Hot Dogs","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"links": [{"rel": "transactions","method": "get","href": "https://api.payroc.com/v1/transactions?batchId=123"},{"rel": "authorizations","method": "get","href": "https://api.payroc.com/v1/authorizations?batchId=123"}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/transactions?date=2021-09-05&batchId=12345' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 1,"hasMore": false,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/transctions?before=65&limit=2&date=2021-01-01"}],"data": [{"transactionId": 65,"type": "capture","date": "2021-01-01","amount": 25000,"entryMethod": "ecommerce","createdDate": "2021-09-05","lastModifiedDate": "2021-09-06","status": "paid","cashbackAmount": 0,"interchange": {"basisPoint": 0,"transactionFee": 0},"currency": "USD","merchant": {"merchantId": "4525644354","doingBusinessAs": "Pizza Doe","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"settled": {"settledBy": "3rd party","achDate": "2021-09-05"},"batch": {"batchId": 12,"date": "2021-01-01","cycle": "am","link": {"rel": "batch","method": "get","href": "https://api.payroc.com/v1/batches/12"}},"card": {"cardNumber": "12456**********4124","type": "visa","cvvPresenceIndicator": true,"avsRequest": true,"avsResponse": ""},"authorization": {"authorizationId": 12345,"code": "ABCDE","amount": 100,"avsResponseCode": "","link": {"rel": "authorization","method": "get","href": "https://api.payroc.com/v1/authorizations/12345"}}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/transactions/89 \--header 'Authorization: Bearer <access token>'
application/json
{"transactionId": 12345,"type": "capture","date": "2021-01-01","amount": 25000,"entryMethod": "barcodeRead","createdDate": "2024-01-30","lastModifiedDate": "2024-01-30","status": "fullSuspense","cashbackAmount": 89,"interchange": {"basisPoint": 89,"transactionFee": 89},"currency": "abc123","merchant": {"merchantId": "4525644354","doingBusinessAs": "Doe Hot Dogs","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"settled": {"settledBy": "abc123","achDate": "2021-09-05"},"batch": {"batchId": 1234,"date": "2021-09-05","cycle": "am","link": {"rel": "previous","method": "get","href": "<uri>"}},"card": {"cardNumber": "123456**********4124","type": "visa","cvvPresenceIndicator": false,"avsRequest": false,"avsResponse": "abc123"},"authorization": {"authorizationId": 12345,"code": "abc123","amount": 89,"avsResponseCode": "abc123","link": {"rel": "previous","method": "get","href": "<uri>"}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/authorizations?date=2021-09-05&batchId=12345' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 1,"hasMore": false,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/authorizations?before=65&limit=2&date=2021-01-01"}],"data": [{"authorizationId": 65,"createdDate": "2021-09-05","lastModifiedDate": "2021-09-06","authorizationResponse": "successful","preauthorizationRequestAmount": 10000,"currency": "USD","merchant": {"merchantId": "4525644354","doingBusinessAs": "Pizza Doe","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"batch": {"batchId": 12,"date": "2021-01-01","cycle": "am","link": {"rel": "batch","method": "get","href": "https://api.payroc.com/v1/batches/12"}},"card": {"cardNumber": "12456**********4124","type": "visa","cvvPresenceIndicator": true,"avsRequest": true,"avsResponse": ""},"transaction": {"transactionId": 12345,"type": "capture","date": "","entryMethod": "swiped","amount": 100,"link": {"rel": "transaction","method": "get","href": "https://api.payroc.com/v1/transactions/12345"}}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url https://api.payroc.com/v1/authorizations/89 \--header 'Authorization: Bearer <access token>'
application/json
{"authorizationId": 12345,"createdDate": "2024-01-30","lastModifiedDate": "2024-01-30","authorizationResponse": "activityCountLimitExceeded","preauthorizationRequestAmount": 10000,"currency": "abc123","batch": {"batchId": 1234,"date": "2021-09-05","cycle": "am","link": {"rel": "previous","method": "get","href": "<uri>"}},"card": {"cardNumber": "123456**********4124","type": "visa","cvvPresenceIndicator": false,"avsRequest": false,"avsResponse": "abc123"},"merchant": {"merchantId": "4525644354","doingBusinessAs": "Doe Hot Dogs","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"transaction": {"transactionId": 12345,"type": "capture","date": "2021-01-01","entryMethod": "barcodeRead","amount": 25000,"link": {"rel": "previous","method": "get","href": "<uri>"}}}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
curl --request get \--url 'https://api.payroc.com/v1/disputes?date=2022-10-01' \--header 'Authorization: Bearer <access token>'
application/json
{"limit": 2,"count": 1,"hasMore": false,"links": [{"rel": "previous","method": "get","href": "https://api.payroc.com/v1/disputes?before=65&limit=2&date=2021-01-01"}],"data": [{"disputeId": 65,"disputeType": "firstDispute","currentStatus": {"disputeStatusId": 123,"status": "new","statusDate": "2021-09-06","link": {"rel": "statuses","method": "get","href": "https://api.payroc.com/v1/disputes/12345/statuses"}},"createdDate": "2021-09-05","lastModifiedDate": "2021-09-06","receivedDate": "","description": "","referenceNumber": "35435435","disputeAmount": 1000,"feeAmount": 100,"firstDispute": true,"authorizationCode": "574254","currency": "USD","merchant": {"merchantId": "4525644354","doingBusinessAs": "Pizza Doe","link": {"rel": "merchant","method": "get","href": "https://api.payroc.com/v1/merchants/4525644354"}},"card": {"cardNumber": "12456**********4124","type": "visa","cvvPresenceIndicator": true,"avsRequest": true,"avsResponse": ""},"transaction": {"transactionId": 12345,"type": "capture","date": "","entryMethod": "swiped","amount": 100,"link": {"rel": "transaction","method": "get","href": "https://api.payroc.com/v1/transactions/12345"}}}]}
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |
GET /disputes/{disputeId}/statusesRetrieve the status history for a specific dispute.
curl --request get \--url https://api.payroc.com/v1/disputes/89/statuses \--header 'Authorization: Bearer <access token>'
application/json
[{"disputeStatusId": 12345,"status": "prearbitrationInProcess","statusDate": "2024-02-01"}]
Error | Description |
---|---|
Bad Request | One or more validation errors occurred |
Not Authorized | Your identity could not be verified |
Forbidden | You do not have the required permission |
Not found | Resource could not be found |
Not acceptable | Requested representation not supported |
Api error | Unable to process your request. |