From 3dcbc03519db6d5442be977c7daf3b1d40643470 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matou=C5=A1=20Dzivjak?= Date: Tue, 7 Jan 2025 12:25:49 +0100 Subject: [PATCH] feat: init --- .github/dependabot.yml | 7 + .github/workflows/generate.yaml | 34 + CODE_OF_CONDUCT.md | 132 + LICENSE | 201 + README.md | 9 + SECURITY.md | 21 + SumUpAPICollection.json | 9865 +++++++++++++++++++++++++++++++ openapi.json | 1 + openapi.yaml | 6115 +++++++++++++++++++ 9 files changed, 16385 insertions(+) create mode 100644 .github/dependabot.yml create mode 100644 .github/workflows/generate.yaml create mode 100644 CODE_OF_CONDUCT.md create mode 100644 LICENSE create mode 100644 README.md create mode 100644 SECURITY.md create mode 100644 SumUpAPICollection.json create mode 100755 openapi.json create mode 100644 openapi.yaml diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..1b311b8 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,7 @@ +version: 2 +updates: + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "daily" + open-pull-requests-limit: 3 diff --git a/.github/workflows/generate.yaml b/.github/workflows/generate.yaml new file mode 100644 index 0000000..7482486 --- /dev/null +++ b/.github/workflows/generate.yaml @@ -0,0 +1,34 @@ +name: Generate + +on: + workflow_dispatch: {} + pull_request: + paths: + - openapi.json + branches: + - main + +jobs: + generate: + name: Generate + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 + with: + repository: ${{ github.event.pull_request.head.repo.full_name }} + ref: ${{ github.event.pull_request.head.ref }} + + - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0 + with: + node-version: 20 + + # https://github.com/postmanlabs/openapi-to-postman + - run: npm i -g openapi-to-postmanv2 + + - run: openapi2postmanv2 -s openapi.json -o SumUpAPICollection.json -p -O folderStrategy=Tags,includeAuthInfoInExample=falseg + + - uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 # v9.1.4 + with: + add: . + message: "chore: generate code" + default_author: github_actions diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..0cf1830 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,132 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, caste, color, religion, or sexual +identity and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +- Demonstrating empathy and kindness toward other people +- Being respectful of differing opinions, viewpoints, and experiences +- Giving and gracefully accepting constructive feedback +- Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +- Focusing on what is best not just for us as individuals, but for the overall + community + +Examples of unacceptable behavior include: + +- The use of sexualized language or imagery, and sexual attention or advances of + any kind +- Trolling, insulting or derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or email address, + without their explicit permission +- Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official e-mail address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders at [integration@sumup.com](mailto:integration@sumup.com) +responsible for enforcement. +All complaints will be reviewed and investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Enforcement Guidelines + +Community leaders will follow these Community Impact Guidelines in determining +the consequences for any action they deem in violation of this Code of Conduct: + +### 1. Correction + +**Community Impact**: Use of inappropriate language or other behavior deemed +unprofessional or unwelcome in the community. + +**Consequence**: A private, written warning from community leaders, providing +clarity around the nature of the violation and an explanation of why the +behavior was inappropriate. A public apology may be requested. + +### 2. Warning + +**Community Impact**: A violation through a single incident or series of +actions. + +**Consequence**: A warning with consequences for continued behavior. No +interaction with the people involved, including unsolicited interaction with +those enforcing the Code of Conduct, for a specified period of time. This +includes avoiding interactions in community spaces as well as external channels +like social media. Violating these terms may lead to a temporary or permanent +ban. + +### 3. Temporary Ban + +**Community Impact**: A serious violation of community standards, including +sustained inappropriate behavior. + +**Consequence**: A temporary ban from any sort of interaction or public +communication with the community for a specified period of time. No public or +private interaction with the people involved, including unsolicited interaction +with those enforcing the Code of Conduct, is allowed during this period. +Violating these terms may lead to a permanent ban. + +### 4. Permanent Ban + +**Community Impact**: Demonstrating a pattern of violation of community +standards, including sustained inappropriate behavior, harassment of an +individual, or aggression toward or disparagement of classes of individuals. + +**Consequence**: A permanent ban from any sort of public interaction within the +community. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.1, available at +[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]. + +Community Impact Guidelines were inspired by +[Mozilla's code of conduct enforcement ladder][mozilla coc]. + +For answers to common questions about this code of conduct, see the FAQ at +[https://www.contributor-covenant.org/faq][faq]. Translations are available at +[https://www.contributor-covenant.org/translations][translations]. + +[homepage]: https://www.contributor-covenant.org +[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html +[mozilla coc]: https://github.com/mozilla/diversity +[faq]: https://www.contributor-covenant.org/faq +[translations]: https://www.contributor-covenant.org/translations diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..f9bd2d0 --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + +Copyright 2019 SumUp Ltd + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/README.md b/README.md new file mode 100644 index 0000000..ac6feb4 --- /dev/null +++ b/README.md @@ -0,0 +1,9 @@ +
+ +# SumUp API Postman Collection + +
+ +The SumUp API Collection is available within Postman's API network at [https://www.postman.com/sumupengineering/sumup-developers](https://www.postman.com/sumupengineering/sumup-developers). + +For detailed documentation see [https://developer.sumup.com/api](https://developer.sumup.com/api). diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..b512772 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,21 @@ +# Security Policy + +The security of SumUp APIs is of paramount importance to us, and we genuinely appreciate the community's efforts to identify and report vulnerabilities. + +## Supported Versions + +We recommend users stay updated with the latest version of our project for optimal stability and security. + +## Reporting a Vulnerability + +Please do not open GitHub issues or pull requests - this makes the vulnerability immediately visible to everyone, including malicious actors. Security issues in this open-source project can be safely reported via the private SumUp bug bounty program. + +To get an invite to our Hackerone private bug bounty program reach out to us via bugbounty at sumup com. + +The SumUp security team will triage your report and determine whether or not is it eligible for a bounty under our program. + +## General Guidelines + +- **Prioritize Confidentiality:** We urge you not to disclose the vulnerability publicly until it's been addressed, ensuring the broader community isn't inadvertently put at risk. +- **Ethical Practices:** Engage in responsible and ethical behavior. Refrain from actions that compromise user privacy, system integrity, or availability. +- **When in Doubt, Reach Out:** If you're uncertain about the significance of a potential security issue, it's always better to err on the side of caution and notify us. diff --git a/SumUpAPICollection.json b/SumUpAPICollection.json new file mode 100644 index 0000000..ac2b75d --- /dev/null +++ b/SumUpAPICollection.json @@ -0,0 +1,9865 @@ +{ + "item": [ + { + "name": "Authorization", + "description": "SumUp API uses [API keys](/online-payments/introduction/authorization#api-keys) for authentication.\nYou can view and manage your API keys in the [API Keys](/api-keys) section of the [Developer Portal](/).\n\n\nAPI keys are short static tokens that are passed in the `Authorization` header to authenticate the requests.\n\n\nThe tokens have a `sup_sk_` prefix. Your API keys have access to the whole SumUp API, so make sure to keep them secure.\n\n\nAll requests must be made over [HTTPS](https://en.wikipedia.org/wiki/HTTPS) and must be authenticated.\n\n\nAlternatively, SumUp APIs support [OAuth2](/online-payments/introduction/authorization#oauth-20) authentication for applications that want to use SumUp as a platform for other users.\n\n\nRead more about authorization in our [Authorization guide](/online-payments/introduction/authorization).\n", + "item": [ + { + "id": "917afea8-5ab6-4655-bdc4-a9860cdca680", + "name": "Request authorization from users", + "request": { + "name": "Request authorization from users", + "description": { + "content": "Request authorization from users and grant your application access to resources associated with the user's profile.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "authorize" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The type of the expected response. The value must be `code` to indicate that you expect to receive an authorization code.", + "type": "text/plain" + }, + "key": "response_type", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app/).", + "type": "text/plain" + }, + "key": "client_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The URI to which the merchant user is redirected after authorizing your application to access their user's profile data and to which the authorization code is sent. The value must match exactly one of the [registered URIs](https://developer.sumup.com/docs/register-app#3-create-oauth-client-credentials) for your application.", + "type": "text/plain" + }, + "key": "redirect_uri", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "A space-separated list of scopes for which you request authorization. If you don't specify any scopes in the request, your application will be granted authorization for the default scopes.", + "type": "text/plain" + }, + "key": "scope", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "A unique local state that can be used for correlating requests and responses and for preventing [cross-site request forgery](https://tools.ietf.org/html/rfc6749#section-10.12).", + "type": "text/plain" + }, + "key": "state", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "ac4467f3-783f-42e3-8de7-9d7ddc014d2e", + "name": "No Content", + "originalRequest": { + "url": { + "path": [ + "authorize" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The type of the expected response. The value must be `code` to indicate that you expect to receive an authorization code.", + "type": "text/plain" + }, + "key": "response_type", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app/).", + "type": "text/plain" + }, + "key": "client_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The URI to which the merchant user is redirected after authorizing your application to access their user's profile data and to which the authorization code is sent. The value must match exactly one of the [registered URIs](https://developer.sumup.com/docs/register-app#3-create-oauth-client-credentials) for your application.", + "type": "text/plain" + }, + "key": "redirect_uri", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "A space-separated list of scopes for which you request authorization. If you don't specify any scopes in the request, your application will be granted authorization for the default scopes.", + "type": "text/plain" + }, + "key": "scope", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "A unique local state that can be used for correlating requests and responses and for preventing [cross-site request forgery](https://tools.ietf.org/html/rfc6749#section-10.12).", + "type": "text/plain" + }, + "key": "state", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "29aa86b8-7f09-447a-98a1-5228d5542b9a", + "name": "Generate a token", + "request": { + "name": "Generate a token", + "description": { + "content": "Generate a token or a refresh token\n", + "type": "text/plain" + }, + "url": { + "path": [ + "token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"grant_type\": \"refresh_token\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"refresh_token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "a16a4378-6dae-4b15-bfb6-4e4765976e94", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"grant_type\": \"refresh_token\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"refresh_token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"access_token\": \"\",\n \"expires_in\": \"\",\n \"refresh_token\": \"\",\n \"scope\": \"\",\n \"token_type\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "172a8c21-6b78-4898-bf4e-b90701fa2cc0", + "name": "Bad Request", + "originalRequest": { + "url": { + "path": [ + "token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"grant_type\": \"refresh_token\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"refresh_token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Checkouts", + "description": "Accept payments from your end users by adding the Checkouts model to your platform.\nSumUp supports standard and single payment 3DS checkout flows.\n\nThe Checkout model allows creating, listing, retrieving, processing and deactivating checkouts.\nA payment is completed by creating a checkout and then processing the checkout.\n", + "item": [ + { + "id": "af73fbfe-da7e-4707-b528-07860193d806", + "name": "List checkouts", + "request": { + "name": "List checkouts", + "description": { + "content": "Lists created checkout resources according to the applied `checkout_reference`.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Filters the list of checkout resources by the unique ID of the checkout.", + "type": "text/plain" + }, + "key": "checkout_reference", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "1e8d271b-9e34-4c89-b245-1ef8e734b5c6", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Filters the list of checkout resources by the unique ID of the checkout.", + "type": "text/plain" + }, + "key": "checkout_reference", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"DKK\",\n \"customer_id\": \"\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"merchant_code\": \"\",\n \"pay_to_email\": \"\",\n \"return_url\": \"\",\n \"status\": \"PAID\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"EUR\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"CZK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"ECOM\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\",\n \"merchant_name\": \"\",\n \"payment_instrument\": {\n \"token\": \"\"\n },\n \"redirect_url\": \"\",\n \"transaction_code\": \"\",\n \"transaction_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"CLP\",\n \"customer_id\": \"\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"merchant_code\": \"\",\n \"pay_to_email\": \"\",\n \"return_url\": \"\",\n \"status\": \"PAID\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"NOK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"SUCCESSFUL\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"RON\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"RECURRING\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\",\n \"merchant_name\": \"\",\n \"payment_instrument\": {\n \"token\": \"\"\n },\n \"redirect_url\": \"\",\n \"transaction_code\": \"\",\n \"transaction_id\": \"\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "b599b942-e867-46f5-a689-2476d495f039", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Filters the list of checkout resources by the unique ID of the checkout.", + "type": "text/plain" + }, + "key": "checkout_reference", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "19383f9a-7428-40da-89fb-195751698a97", + "name": "Create a checkout", + "request": { + "name": "Create a checkout", + "description": { + "content": "Creates a new payment checkout resource. The unique `checkout_reference` created by this request, is used for further manipulation of the checkout.\n\nFor 3DS checkouts, add the `redirect_url` parameter to your request body schema.\n\nFollow by processing a checkout to charge the provided payment instrument.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "8fe90370-4f07-4556-a054-c8990026d6f3", + "name": "Created", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"PLN\",\n \"customer_id\": \"\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"merchant_code\": \"\",\n \"pay_to_email\": \"\",\n \"return_url\": \"\",\n \"status\": \"PAID\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"ECOM\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"USD\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "c20f290d-0576-4c5a-a419-5041745a7afe", + "name": "Bad Request", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\",\n \"param\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "5494b175-c22e-40da-ae14-da3e28e84017", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "74abc6ec-54a8-4aa1-b3a3-f5df5669b174", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "15d7fa38-6c7c-49bf-80a4-08274f15497d", + "name": "Conflict", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"checkout_reference\": \"\",\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"merchant_code\": \"\",\n \"customer_id\": \"\",\n \"description\": \"\",\n \"pay_to_email\": \"\",\n \"payment_type\": \"\",\n \"personal_details\": {\n \"address\": {\n \"city\": \"\",\n \"country\": \"\",\n \"line_1\": \"\",\n \"postal_code\": \"99477-090\",\n \"state\": \"RS\"\n },\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"tax_id\": \"\"\n },\n \"purpose\": \"CHECKOUT\",\n \"redirect_url\": \"\",\n \"return_url\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Conflict", + "code": 409, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "3ddb8004-4810-42db-b4fc-0e7c34785ff0", + "name": "Deactivate a checkout", + "request": { + "name": "Deactivate a checkout", + "description": { + "content": "Deactivates an identified checkout resource. If the checkout has already been processed it can not be deactivated.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the checkout resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "a1d0dd31-296a-44cc-b2c2-e60f736740d4", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"USD\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"merchant_code\": \"\",\n \"merchant_country\": \"\",\n \"merchant_name\": \"\",\n \"pay_to_email\": \"\",\n \"purpose\": \"SETUP_RECURRING_PAYMENT\",\n \"status\": \"EXPIRED\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"CZK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"DKK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"CANCELLED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "fbee14f4-db50-4e1f-a7d3-978d7f84ec02", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "a47d41da-db1f-4389-bc5e-6259e0127ede", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "3f1d0f03-284a-4c3d-b5e0-942d936a2716", + "name": "Conflict", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Conflict", + "code": 409, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "946a8f6b-4437-476b-8f1a-c7b7501d217b", + "name": "Retrieve a checkout", + "request": { + "name": "Retrieve a checkout", + "description": { + "content": "Retrieves an identified checkout resource. Use this request after processing a checkout to confirm its status and inform the end user respectively.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the checkout resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "604b68b4-4029-4d6d-aeda-bbb3f2afa3c3", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"EUR\",\n \"customer_id\": \"\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"merchant_code\": \"\",\n \"pay_to_email\": \"\",\n \"return_url\": \"\",\n \"status\": \"FAILED\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"NOK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"RECURRING\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"HRK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"ECOM\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\",\n \"merchant_name\": \"\",\n \"payment_instrument\": {\n \"token\": \"\"\n },\n \"redirect_url\": \"\",\n \"transaction_code\": \"\",\n \"transaction_id\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "caa086a3-d7aa-4a14-9db7-465d38d02184", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "061c0458-e72a-477b-a39d-24065a654e80", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "3475f7af-660b-4a30-9563-b906d9dce362", + "name": "Process a checkout", + "request": { + "name": "Process a checkout", + "description": { + "content": "Processing a checkout will attempt to charge the provided payment instrument for the amount of the specified checkout resource initiated in the `Create a checkout` endpoint.\n\nFollow this request with `Retrieve a checkout` to confirm its status.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the checkout resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "acf2bbea-fc1d-48ff-8d8c-ac35265841fc", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"checkout_reference\": \"\",\n \"currency\": \"EUR\",\n \"customer_id\": \"\",\n \"date\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"merchant_code\": \"\",\n \"pay_to_email\": \"\",\n \"return_url\": \"\",\n \"status\": \"FAILED\",\n \"transactions\": [\n {\n \"amount\": \"\",\n \"currency\": \"NOK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"RECURRING\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"BOLETO\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"HRK\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"ECOM\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\"\n }\n ],\n \"valid_until\": \"\",\n \"merchant_name\": \"\",\n \"payment_instrument\": {\n \"token\": \"\"\n },\n \"redirect_url\": \"\",\n \"transaction_code\": \"\",\n \"transaction_id\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "04190f54-0a76-4444-9ca4-66d195320e0f", + "name": "Bad Request", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\",\n \"param\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "e0f57dbc-1b4a-480f-8d2e-83ace97214de", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "37ea8058-3556-4bca-b41a-d3df52142e4a", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "2950a916-f1bb-4baf-ba9d-8256f1968de1", + "name": "Conflict", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "checkouts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"payment_type\": \"blik\",\n \"card\": {\n \"name\": \"\",\n \"number\": \"\",\n \"expiry_month\": \"03\",\n \"expiry_year\": \"\",\n \"cvv\": \"\",\n \"zip_code\": \"\",\n \"last_4_digits\": -7465396\n },\n \"customer_id\": \"\",\n \"installments\": \"\",\n \"mandate\": {\n \"type\": \"recurrent\",\n \"user_agent\": \"\",\n \"user_ip\": \"\"\n },\n \"token\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Conflict", + "code": 409, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "8257907c-3fe0-4632-b784-b6ac17c49364", + "name": "Get available payment methods", + "request": { + "name": "Get available payment methods", + "description": { + "content": "Get payment methods available for the given merchant to use with a checkout.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "payment-methods" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.", + "type": "text/plain" + }, + "key": "amount", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The currency for which the payment methods should be eligible.", + "type": "text/plain" + }, + "key": "currency", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) The SumUp merchant code.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "6c5b9248-69ea-4706-9df1-f3ed7ee833ff", + "name": "Available payment methods", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "payment-methods" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.", + "type": "text/plain" + }, + "key": "amount", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The currency for which the payment methods should be eligible.", + "type": "text/plain" + }, + "key": "currency", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"available_payment_methods\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "a6db8bd2-27c1-4725-beb6-d3b4fbffac5a", + "name": "Bad Request", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "payment-methods" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.", + "type": "text/plain" + }, + "key": "amount", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The currency for which the payment methods should be eligible.", + "type": "text/plain" + }, + "key": "currency", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"details\": \"\",\n \"failed_constraints\": [\n {\n \"message\": \"\",\n \"reference\": \"\"\n },\n {\n \"message\": \"\",\n \"reference\": \"\"\n }\n ],\n \"status\": \"\",\n \"title\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "165040f7-43ae-46fa-9e71-499aa0926fc1", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "payment-methods" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.", + "type": "text/plain" + }, + "key": "amount", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The currency for which the payment methods should be eligible.", + "type": "text/plain" + }, + "key": "currency", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Customers", + "description": "Allow your regular customers to save their information with the Customers model.\nThis will prevent re-entering payment instrument information for recurring payments on your platform.\n\nDepending on the needs you can allow, creating, listing or deactivating payment instruments & creating, retrieving and updating customers.\n", + "item": [ + { + "id": "d1bf1d08-f2ee-4142-9276-da037010c081", + "name": "Create a customer", + "request": { + "name": "Create a customer", + "description": { + "content": "Creates a new saved customer resource which you can later manipulate and save payment instruments to.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "customers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "012d9eb3-cac7-4cfe-a889-183b5a4292fa", + "name": "Created", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "1fabb7b2-3bf4-494e-a1a1-58469103777a", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "7bc40b2f-8fe3-453d-8931-2ece100b0f46", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "4e8a22c2-16e6-4f17-a890-b206f36fee94", + "name": "Conflict", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Conflict", + "code": 409, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "a28bfc7f-1479-49c6-aff1-a0fbf4c32037", + "name": "Retrieve a customer", + "request": { + "name": "Retrieve a customer", + "description": { + "content": "Retrieves an identified saved customer resource through the unique `customer_id` parameter, generated upon customer creation.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "customer_id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the saved customer resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "9de8c927-7d32-414c-acf8-bc1c2d18561c", + "name": "Created", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "baf9f066-c5e7-4001-ba89-7cbb05563c1f", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "8fb1c869-6271-4091-9d53-4e4a9e55533d", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "e66b1d9f-be15-46b0-a2e7-3b2e032a8951", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "826d1ec4-e93d-407c-812d-79f2b28595c8", + "name": "Update a customer", + "request": { + "name": "Update a customer", + "description": { + "content": "Updates an identified saved customer resource's personal details.\n\nThe request only overwrites the parameters included in the request, all other parameters will remain with their initially assigned values.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "customer_id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the saved customer resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "dc30cdab-8ac7-46cd-90b8-fc145daa5a64", + "name": "Created", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"customer_id\": \"\",\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "f93ce46f-6e5f-4878-953a-ac1533f7b1db", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "934e5fbf-2b1b-40ba-9e2d-36d644877428", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "b62e581b-526c-46f7-b264-842fa1cc3d41", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"personal_details\": {\n \"address\": {\n \"country\": \"\",\n \"city\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"postal_code\": \"\",\n \"state\": \"\"\n },\n \"birthdate\": \"\",\n \"email\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "2ff280a1-af4e-40ff-b6e9-4753e3a40413", + "name": "List payment instruments", + "request": { + "name": "List payment instruments", + "description": { + "content": "Lists all payment instrument resources that are saved for an identified customer.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "customer_id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the saved customer resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "9bf62044-9c69-4035-8361-020e9672c3d0", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"active\": true,\n \"card\": {\n \"last_4_digits\": \"\",\n \"type\": \"DINERS\"\n },\n \"created_at\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"token\": \"\",\n \"type\": \"card\"\n },\n {\n \"active\": true,\n \"card\": {\n \"last_4_digits\": \"\",\n \"type\": \"VISA_ELECTRON\"\n },\n \"created_at\": \"\",\n \"mandate\": {\n \"merchant_code\": \"\",\n \"status\": \"\",\n \"type\": \"\"\n },\n \"token\": \"\",\n \"type\": \"card\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "98e74599-7efb-4a9d-931c-a19d4282c493", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "70f65ebc-32c6-45c5-bc3d-c107caf5f46f", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "f3422466-7119-43e7-b1ca-4c0900d92ac7", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "d251523c-a5f0-42a6-9719-04ab910bd1ec", + "name": "Deactivate a payment instrument", + "request": { + "name": "Deactivate a payment instrument", + "description": { + "content": "Deactivates an identified card payment instrument resource for a customer.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments", + ":token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "customer_id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the saved customer resource.", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "token", + "disabled": false, + "description": { + "content": "(Required) Unique token identifying the card saved as a payment instrument resource.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "2dbbb9ad-fbcf-4760-b660-b30d1eef3eac", + "name": "No Content", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments", + ":token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "No Content", + "code": 204, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "56b53fb1-1eb9-459d-afe3-7809f3d63614", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments", + ":token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "a1621c8e-b219-496c-813b-ed0e83672ebf", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments", + ":token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "47fe2426-8b1e-4e46-a8b4-626f543ca270", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "customers", + ":customer_id", + "payment-instruments", + ":token" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Transactions", + "description": "Retrieve details for a specific transaction by it’s `id`\nor any other required query parameter, or list all transactions related to the merchant account.\n", + "item": [ + { + "id": "29b1c1fc-d0b6-44e1-85a9-158870f99466", + "name": "Refund a transaction", + "request": { + "name": "Refund a transaction", + "description": { + "content": "Refunds an identified transaction either in full or partially.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "refund", + ":txn_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "txn_id", + "disabled": false, + "description": { + "content": "(Required) Unique ID of the transaction.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"amount\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "ec7db124-e529-4171-97e1-2535677b9050", + "name": "No Content", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "refund", + ":txn_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"amount\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "No Content", + "code": 204, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "e833ad35-24ae-4dfc-b19e-17f11b741b45", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "refund", + ":txn_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"amount\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "967baa19-a3ce-4be1-8f89-549f43b19ade", + "name": "Conflict", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "refund", + ":txn_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"amount\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Conflict", + "code": 409, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "bdd1ef04-ea92-49d3-868d-c69e3e45bf34", + "name": "Retrieve a transaction (deprecated)", + "request": { + "name": "Retrieve a transaction (deprecated)", + "description": { + "content": "Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required:\n * `id`\n * `internal_id`\n * `transaction_code`\n * `foreign_transaction_id`\n * `client_transaction_id`\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "b48cc3df-9469-4cd4-80e3-cb490cc249e4", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"currency\": \"RON\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\",\n \"payout_plan\": \"ACCELERATED_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card\": {\n \"last_4_digits\": \"\",\n \"type\": \"VISA_ELECTRON\"\n },\n \"events\": [\n {\n \"amount\": \"\",\n \"deducted_amount\": \"\",\n \"deducted_fee_amount\": \"\",\n \"fee_amount\": \"\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"SCHEDULED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"REFUND\"\n },\n {\n \"amount\": \"\",\n \"deducted_amount\": \"\",\n \"deducted_fee_amount\": \"\",\n \"fee_amount\": \"\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\"\n }\n ],\n \"horizontal_accuracy\": \"\",\n \"lat\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n },\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n }\n ],\n \"local_time\": \"\",\n \"location\": {\n \"horizontal_accuracy\": \"\",\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"lon\": \"\",\n \"payout_type\": \"BANK_ACCOUNT\",\n \"products\": [\n {\n \"name\": \"\",\n \"price\": \"\",\n \"price_with_vat\": \"\",\n \"quantity\": \"\",\n \"single_vat_amount\": \"\",\n \"total_price\": \"\",\n \"total_with_vat\": \"\",\n \"vat_amount\": \"\",\n \"vat_rate\": \"\"\n },\n {\n \"name\": \"\",\n \"price\": \"\",\n \"price_with_vat\": \"\",\n \"quantity\": \"\",\n \"single_vat_amount\": \"\",\n \"total_price\": \"\",\n \"total_with_vat\": \"\",\n \"vat_amount\": \"\",\n \"vat_rate\": \"\"\n }\n ],\n \"simple_payment_type\": \"EMV\",\n \"simple_status\": \"REFUND_FAILED\",\n \"tax_enabled\": \"\",\n \"transaction_events\": [\n {\n \"amount\": \"\",\n \"date\": \"\",\n \"due_date\": \"\",\n \"event_type\": \"CHARGE_BACK\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\"\n },\n {\n \"amount\": \"\",\n \"date\": \"\",\n \"due_date\": \"\",\n \"event_type\": \"PAYOUT_DEDUCTION\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"PAID_OUT\",\n \"timestamp\": \"\"\n }\n ],\n \"username\": \"\",\n \"verification_method\": \"offline pin\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "2a2990c0-e1a1-4584-b9cc-986ebc33d623", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "a78d22d7-0255-4747-83bd-609a188a943d", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "dc8e080e-b2d6-4bb9-ac07-708017c692d4", + "name": "List transactions (deprecated)", + "request": { + "name": "List transactions (deprecated)", + "description": { + "content": "Lists detailed history of all transactions associated with the merchant profile.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "CANCELLED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "ECOM" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "3bfef9dd-e70b-437d-a728-818671cb2b55", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"items\": [\n {\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"payout_plan\": \"ACCELERATED_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card_type\": \"VISA_VPAY\",\n \"client_transaction_id\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"PAYMENT\",\n \"user\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"USD\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"payout_plan\": \"TRUE_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card_type\": \"VISA_VPAY\",\n \"client_transaction_id\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\",\n \"user\": \"\"\n }\n ],\n \"links\": [\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n },\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "82157885-78ad-4aaf-9c94-cfec8b8171a0", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "88451506-eafd-4121-bf4e-63a9c4695a1f", + "name": "Retrieve a transaction", + "request": { + "name": "Retrieve a transaction", + "description": { + "content": "Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required:\n * `id`\n * `internal_id`\n * `transaction_code`\n * `foreign_transaction_id`\n * `client_transaction_id`\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "79b6f5b1-05e0-41ef-a74d-700781af7191", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"amount\": \"\",\n \"currency\": \"RON\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"auth_code\": \"\",\n \"entry_mode\": \"CUSTOMER_ENTRY\",\n \"internal_id\": \"\",\n \"merchant_code\": \"\",\n \"tip_amount\": \"\",\n \"vat_amount\": \"\",\n \"payout_plan\": \"ACCELERATED_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card\": {\n \"last_4_digits\": \"\",\n \"type\": \"VISA_ELECTRON\"\n },\n \"events\": [\n {\n \"amount\": \"\",\n \"deducted_amount\": \"\",\n \"deducted_fee_amount\": \"\",\n \"fee_amount\": \"\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"SCHEDULED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"REFUND\"\n },\n {\n \"amount\": \"\",\n \"deducted_amount\": \"\",\n \"deducted_fee_amount\": \"\",\n \"fee_amount\": \"\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\"\n }\n ],\n \"horizontal_accuracy\": \"\",\n \"lat\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n },\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n }\n ],\n \"local_time\": \"\",\n \"location\": {\n \"horizontal_accuracy\": \"\",\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"lon\": \"\",\n \"payout_type\": \"BANK_ACCOUNT\",\n \"products\": [\n {\n \"name\": \"\",\n \"price\": \"\",\n \"price_with_vat\": \"\",\n \"quantity\": \"\",\n \"single_vat_amount\": \"\",\n \"total_price\": \"\",\n \"total_with_vat\": \"\",\n \"vat_amount\": \"\",\n \"vat_rate\": \"\"\n },\n {\n \"name\": \"\",\n \"price\": \"\",\n \"price_with_vat\": \"\",\n \"quantity\": \"\",\n \"single_vat_amount\": \"\",\n \"total_price\": \"\",\n \"total_with_vat\": \"\",\n \"vat_amount\": \"\",\n \"vat_rate\": \"\"\n }\n ],\n \"simple_payment_type\": \"EMV\",\n \"simple_status\": \"REFUND_FAILED\",\n \"tax_enabled\": \"\",\n \"transaction_events\": [\n {\n \"amount\": \"\",\n \"date\": \"\",\n \"due_date\": \"\",\n \"event_type\": \"CHARGE_BACK\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\"\n },\n {\n \"amount\": \"\",\n \"date\": \"\",\n \"due_date\": \"\",\n \"event_type\": \"PAYOUT_DEDUCTION\",\n \"id\": \"\",\n \"installment_number\": \"\",\n \"status\": \"PAID_OUT\",\n \"timestamp\": \"\"\n }\n ],\n \"username\": \"\",\n \"verification_method\": \"offline pin\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "739d93ac-b368-48be-a4dc-00e255f7d261", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "1e1cd59f-ea78-4643-a609-b7ec6e4effe4", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).", + "type": "text/plain" + }, + "key": "internal_id", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "aa9e0137-6327-459d-ad9e-243a16a240f2", + "name": "List transactions", + "request": { + "name": "List transactions", + "description": { + "content": "Lists detailed history of all transactions associated with the merchant profile.", + "type": "text/plain" + }, + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "CANCELLED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "ECOM" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "4ebcf4de-1e2f-458c-9a00-2f3539d264e5", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"items\": [\n {\n \"amount\": \"\",\n \"currency\": \"CHF\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"PENDING\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"payout_plan\": \"ACCELERATED_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card_type\": \"VISA_VPAY\",\n \"client_transaction_id\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"PAYMENT\",\n \"user\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"USD\",\n \"id\": \"\",\n \"installments_count\": \"\",\n \"payment_type\": \"BOLETO\",\n \"status\": \"FAILED\",\n \"timestamp\": \"\",\n \"transaction_code\": \"\",\n \"payout_plan\": \"TRUE_INSTALLMENT\",\n \"payouts_received\": \"\",\n \"payouts_total\": \"\",\n \"product_summary\": \"\",\n \"card_type\": \"VISA_VPAY\",\n \"client_transaction_id\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\",\n \"user\": \"\"\n }\n ],\n \"links\": [\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n },\n {\n \"href\": \"\",\n \"rel\": \"\",\n \"type\": \"\"\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "5486c1ae-36da-45e8-ae73-4fd2e481b10b", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v2.1", + "merchants", + ":merchant_code", + "transactions", + "history" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Retrieves the transaction resource with the specified transaction code.", + "type": "text/plain" + }, + "key": "transaction_code", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Specifies the order in which the returned results are displayed.", + "type": "text/plain" + }, + "key": "order", + "value": "ascending" + }, + { + "disabled": false, + "description": { + "content": "Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by user email.", + "type": "text/plain" + }, + "key": "users", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of final statuses of the transactions.", + "type": "text/plain" + }, + "key": "statuses", + "value": "REFUNDED" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of payment types used for the transactions.", + "type": "text/plain" + }, + "key": "payment_types", + "value": "POS" + }, + { + "disabled": false, + "description": { + "content": "Filters the returned results by the specified list of transaction types.", + "type": "text/plain" + }, + "key": "types", + "value": "REFUND" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "changes_since", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "newest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "newest_ref", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "oldest_time", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).", + "type": "text/plain" + }, + "key": "oldest_ref", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Payouts", + "description": "The Payouts model will allow you to track funds you’ve received from SumUp.\nYou can receive a detailed payouts list with information like dates, fees, references and statuses, using the `List payouts` endpoint.\n", + "item": [ + { + "id": "ad696bc5-a378-4de4-978b-7ee49f910ac7", + "name": "List payouts", + "request": { + "name": "List payouts", + "description": { + "content": "Lists ordered payouts for the merchant profile.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "financials", + "payouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Start date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "start_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "(Required) End date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "end_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "format", + "value": "json" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "order", + "value": "desc" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "e99ee1de-7040-48a5-aaac-a499006d17d9", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "financials", + "payouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Start date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "start_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "(Required) End date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "end_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "format", + "value": "json" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "order", + "value": "desc" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"amount\": \"\",\n \"currency\": \"\",\n \"date\": \"\",\n \"fee\": \"\",\n \"id\": \"\",\n \"reference\": \"\",\n \"status\": \"FAILED\",\n \"transaction_code\": \"\",\n \"type\": \"CHARGE_BACK_DEDUCTION\"\n },\n {\n \"amount\": \"\",\n \"currency\": \"\",\n \"date\": \"\",\n \"fee\": \"\",\n \"id\": \"\",\n \"reference\": \"\",\n \"status\": \"FAILED\",\n \"transaction_code\": \"\",\n \"type\": \"REFUND_DEDUCTION\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "923c879c-7782-4489-bd60-26e726c33318", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "financials", + "payouts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Start date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "start_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "(Required) End date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).", + "type": "text/plain" + }, + "key": "end_date", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "format", + "value": "json" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "limit", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "", + "type": "text/plain" + }, + "key": "order", + "value": "desc" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Receipts", + "description": "The Receipts model obtains receipt-like details for specific transactions.", + "item": [ + { + "id": "8929f6f1-f1fb-4015-b311-fdd41a4fefa0", + "name": "Retrieve receipt details", + "request": { + "name": "Retrieve receipt details", + "description": { + "content": "Retrieves receipt specific data for a transaction.", + "type": "text/plain" + }, + "url": { + "path": [ + "v1.1", + "receipts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Merchant code.", + "type": "text/plain" + }, + "key": "mid", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The ID of the transaction event (refund).", + "type": "text/plain" + }, + "key": "tx_event_id", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) SumUp unique transaction ID or transaction code, e.g. TS7HDYLSKD.", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "78754da7-37ab-4569-a4e4-5a98d79dbe46", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "receipts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Merchant code.", + "type": "text/plain" + }, + "key": "mid", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The ID of the transaction event (refund).", + "type": "text/plain" + }, + "key": "tx_event_id", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"acquirer_data\": {\n \"authorization_code\": \"\",\n \"local_time\": \"\",\n \"return_code\": \"\",\n \"tid\": \"\"\n },\n \"emv_data\": {},\n \"merchant_data\": {\n \"locale\": \"\",\n \"merchant_profile\": {\n \"address\": {\n \"address_line1\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"country_en_name\": \"\",\n \"country_native_name\": \"\",\n \"landline\": \"\",\n \"post_code\": \"\"\n },\n \"business_name\": \"\",\n \"email\": \"\",\n \"merchant_code\": \"\"\n }\n },\n \"transaction_data\": {\n \"amount\": \"\",\n \"card\": {\n \"last_4_digits\": \"\",\n \"type\": \"\"\n },\n \"currency\": \"\",\n \"entry_mode\": \"\",\n \"events\": [\n {\n \"amount\": \"\",\n \"id\": \"\",\n \"receipt_no\": \"\",\n \"status\": \"REFUNDED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\"\n },\n {\n \"amount\": \"\",\n \"id\": \"\",\n \"receipt_no\": \"\",\n \"status\": \"SCHEDULED\",\n \"timestamp\": \"\",\n \"transaction_id\": \"\",\n \"type\": \"CHARGE_BACK\"\n }\n ],\n \"installments_count\": \"\",\n \"payment_type\": \"\",\n \"products\": [\n {\n \"description\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"quantity\": \"\",\n \"total_price\": \"\"\n },\n {\n \"description\": \"\",\n \"name\": \"\",\n \"price\": \"\",\n \"quantity\": \"\",\n \"total_price\": \"\"\n }\n ],\n \"receipt_no\": \"\",\n \"status\": \"\",\n \"timestamp\": \"\",\n \"tip_amount\": \"\",\n \"transaction_code\": \"\",\n \"vat_amount\": \"\",\n \"vat_rates\": [\n {\n \"gross\": \"\",\n \"net\": \"\",\n \"rate\": \"\",\n \"vat\": \"\"\n },\n {\n \"gross\": \"\",\n \"net\": \"\",\n \"rate\": \"\",\n \"vat\": \"\"\n }\n ],\n \"verification_method\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "3d9c2960-198f-4c1e-8963-b454c18b2903", + "name": "Not Found", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "receipts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Merchant code.", + "type": "text/plain" + }, + "key": "mid", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The ID of the transaction event (refund).", + "type": "text/plain" + }, + "key": "tx_event_id", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "c41ac7d4-579e-4e7d-96f2-500166022fe8", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "receipts", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "(Required) Merchant code.", + "type": "text/plain" + }, + "key": "mid", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "The ID of the transaction event (refund).", + "type": "text/plain" + }, + "key": "tx_event_id", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Merchant", + "description": "Manage merchant profile.", + "item": [ + { + "id": "abf9bc9c-1e2f-41df-93e5-46b288e19f21", + "name": "Retrieve a profile", + "request": { + "name": "Retrieve a profile", + "description": { + "content": "Returns user profile information.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.", + "type": "text/plain" + }, + "key": "include[]", + "value": "doing_business_as" + }, + { + "disabled": false, + "description": { + "content": "A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.", + "type": "text/plain" + }, + "key": "include[]", + "value": "doing_business_as" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "43c4e05a-1d11-4009-8758-dcc1cee70730", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.", + "type": "text/plain" + }, + "key": "include[]", + "value": "doing_business_as" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"account\": {\n \"type\": \"normal\",\n \"username\": \"\"\n },\n \"app_settings\": {\n \"advanced_mode\": \"\",\n \"barcode_scanner\": \"\",\n \"cash_payment\": \"\",\n \"checkout_preference\": \"\",\n \"expected_max_transaction_amount\": \"\",\n \"include_vat\": \"\",\n \"manual_entry\": \"\",\n \"manual_entry_tutorial\": \"\",\n \"mobile_payment\": \"\",\n \"mobile_payment_tutorial\": \"\",\n \"reader_payment\": \"\",\n \"referral\": \"\",\n \"tax_enabled\": \"\",\n \"terminal_mode_tutorial\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ],\n \"tipping\": \"\"\n },\n \"is_migrated_payleven_br\": \"\",\n \"merchant_profile\": {\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"country_details\": {\n \"currency\": \"\",\n \"en_name\": \"\",\n \"iso_code\": \"\",\n \"native_name\": \"\"\n },\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"post_code\": \"\",\n \"region_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\",\n \"state_id\": \"\",\n \"timeoffset_details\": {\n \"dst\": \"\",\n \"offset\": \"\",\n \"post_code\": \"\"\n }\n },\n \"bank_accounts\": [\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n },\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n }\n ],\n \"business_owners\": [\n {\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\",\n \"ownership\": \"\"\n },\n {\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\",\n \"ownership\": \"\"\n }\n ],\n \"company_name\": \"\",\n \"company_registration_number\": \"\",\n \"country\": \"\",\n \"doing_business_as\": {\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"post_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\"\n },\n \"business_name\": \"\",\n \"company_registration_number\": \"\",\n \"email\": \"\",\n \"vat_id\": \"\",\n \"website\": \"\"\n },\n \"extdev\": \"\",\n \"legal_type\": {\n \"description\": \"\",\n \"full_description\": \"\",\n \"id\": \"\",\n \"sole_trader\": \"\"\n },\n \"locale\": \"\",\n \"merchant_category_code\": \"\",\n \"merchant_code\": \"\",\n \"mobile_phone\": \"\",\n \"nature_and_purpose\": \"\",\n \"payout_zone_migrated\": \"\",\n \"permanent_certificate_access_code\": \"\",\n \"settings\": {\n \"daily_payout_email\": \"\",\n \"gross_settlement\": \"\",\n \"monthly_payout_email\": \"\",\n \"moto_payment\": \"ENFORCED\",\n \"payout_instrument\": \"\",\n \"payout_on_demand\": \"\",\n \"payout_on_demand_available\": \"\",\n \"payout_period\": \"\",\n \"payout_type\": \"\",\n \"printers_enabled\": \"\",\n \"stone_merchant_code\": \"\",\n \"tax_enabled\": \"\"\n },\n \"vat_id\": \"\",\n \"vat_rates\": {\n \"country\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"ordering\": \"\",\n \"rate\": \"\"\n },\n \"website\": \"\"\n },\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n },\n \"personal_profile\": {\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"country_details\": {\n \"currency\": \"\",\n \"en_name\": \"\",\n \"iso_code\": \"\",\n \"native_name\": \"\"\n },\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"post_code\": \"\",\n \"region_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\",\n \"state_id\": \"\",\n \"timeoffset_details\": {\n \"dst\": \"\",\n \"offset\": \"\",\n \"post_code\": \"\"\n }\n },\n \"complete\": \"\",\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "adbdcf83-a934-4a04-9c85-d43579a790e1", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.", + "type": "text/plain" + }, + "key": "include[]", + "value": "doing_business_as" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "dcbeeea7-c6ea-4a50-9897-1f808a518fca", + "name": "Retrieve a merchant profile", + "request": { + "name": "Retrieve a merchant profile", + "description": { + "content": "Retrieves merchant profile data.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "cc9d0f52-b7cb-4107-a9bb-0d9e81ce50dd", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"country_details\": {\n \"currency\": \"\",\n \"en_name\": \"\",\n \"iso_code\": \"\",\n \"native_name\": \"\"\n },\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"post_code\": \"\",\n \"region_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\",\n \"state_id\": \"\",\n \"timeoffset_details\": {\n \"dst\": \"\",\n \"offset\": \"\",\n \"post_code\": \"\"\n }\n },\n \"bank_accounts\": [\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n },\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n }\n ],\n \"business_owners\": [\n {\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\",\n \"ownership\": \"\"\n },\n {\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\",\n \"ownership\": \"\"\n }\n ],\n \"company_name\": \"\",\n \"company_registration_number\": \"\",\n \"country\": \"\",\n \"doing_business_as\": {\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"post_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\"\n },\n \"business_name\": \"\",\n \"company_registration_number\": \"\",\n \"email\": \"\",\n \"vat_id\": \"\",\n \"website\": \"\"\n },\n \"extdev\": \"\",\n \"legal_type\": {\n \"description\": \"\",\n \"full_description\": \"\",\n \"id\": \"\",\n \"sole_trader\": \"\"\n },\n \"locale\": \"\",\n \"merchant_category_code\": \"\",\n \"merchant_code\": \"\",\n \"mobile_phone\": \"\",\n \"nature_and_purpose\": \"\",\n \"payout_zone_migrated\": \"\",\n \"permanent_certificate_access_code\": \"\",\n \"settings\": {\n \"daily_payout_email\": \"\",\n \"gross_settlement\": \"\",\n \"monthly_payout_email\": \"\",\n \"moto_payment\": \"ENFORCED\",\n \"payout_instrument\": \"\",\n \"payout_on_demand\": \"\",\n \"payout_on_demand_available\": \"\",\n \"payout_period\": \"\",\n \"payout_type\": \"\",\n \"printers_enabled\": \"\",\n \"stone_merchant_code\": \"\",\n \"tax_enabled\": \"\"\n },\n \"vat_id\": \"\",\n \"vat_rates\": {\n \"country\": \"\",\n \"description\": \"\",\n \"id\": \"\",\n \"ordering\": \"\",\n \"rate\": \"\"\n },\n \"website\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "b4bdb768-0795-4d1d-bb08-46bf692b26f9", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "c8e095d1-b865-48a6-a0ef-ab232d14c559", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "8fe7bd77-3400-4edb-acff-03b472c095f6", + "name": "List bank accounts (deprecated)", + "request": { + "name": "List bank accounts (deprecated)", + "description": { + "content": "Retrieves bank accounts of the merchant.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "70051e00-ccee-4e04-94a9-6ad1097f0999", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n },\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "e17868e0-6050-4033-a620-5e7e7752534e", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "862a0966-2a5e-49e3-9c09-132233c8d9aa", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "f52dcdc7-3b3b-4bec-ba48-f6b348fdd147", + "name": "Retrieve DBA", + "request": { + "name": "Retrieve DBA", + "description": { + "content": "Retrieves Doing Business As profile.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "doing-business-as" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "fa880292-a1ca-40f4-82eb-27a4497e5638", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "doing-business-as" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"post_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\"\n },\n \"business_name\": \"\",\n \"company_registration_number\": \"\",\n \"email\": \"\",\n \"vat_id\": \"\",\n \"website\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "0db9314b-c57b-443b-a381-76e5a40fe767", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "doing-business-as" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "0a2bf02e-a682-4775-b3e4-e90d18c378ef", + "name": "Get settings", + "request": { + "name": "Get settings", + "description": { + "content": "Retrieves merchant settings.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "settings" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "75405e64-7ea4-4be1-937a-3aef994a3dd0", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "settings" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"daily_payout_email\": \"\",\n \"gross_settlement\": \"\",\n \"monthly_payout_email\": \"\",\n \"moto_payment\": \"ENFORCED\",\n \"payout_instrument\": \"\",\n \"payout_on_demand\": \"\",\n \"payout_on_demand_available\": \"\",\n \"payout_period\": \"\",\n \"payout_type\": \"\",\n \"printers_enabled\": \"\",\n \"stone_merchant_code\": \"\",\n \"tax_enabled\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "d9736501-67da-42cd-b592-f50bc8c9c401", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "settings" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "34b151fb-1c9a-45fa-b0d7-90c513b9652c", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "merchant-profile", + "settings" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "33ed4003-ca77-4929-a673-dfeeed9858ed", + "name": "Retrieve a personal profile", + "request": { + "name": "Retrieve a personal profile", + "description": { + "content": "Retrieves personal profile data.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "personal-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "856e89b7-68fb-4f6b-b18d-fa1d5f4d7929", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "personal-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"address\": {\n \"address_line1\": \"\",\n \"address_line2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"country_details\": {\n \"currency\": \"\",\n \"en_name\": \"\",\n \"iso_code\": \"\",\n \"native_name\": \"\"\n },\n \"first_name\": \"\",\n \"landline\": \"\",\n \"last_name\": \"\",\n \"post_code\": \"\",\n \"region_code\": \"\",\n \"region_id\": \"\",\n \"region_name\": \"\",\n \"state_id\": \"\",\n \"timeoffset_details\": {\n \"dst\": \"\",\n \"offset\": \"\",\n \"post_code\": \"\"\n }\n },\n \"complete\": \"\",\n \"date_of_birth\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"mobile_phone\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "82f4a42c-5873-4ad6-8ee8-ecc8e1c59a0a", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "personal-profile" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "c6bacc58-20d0-4b65-b14d-1ffa3a49d857", + "name": "List bank accounts", + "request": { + "name": "List bank accounts", + "description": { + "content": "Retrieves bank accounts of the merchant.", + "type": "text/plain" + }, + "url": { + "path": [ + "v1.1", + "merchants", + ":merchant_code", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "c6bc4432-18d8-48f4-9b05-f266c39999d4", + "name": "OK", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "merchants", + ":merchant_code", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n },\n {\n \"account_category\": \"\",\n \"account_holder_name\": \"\",\n \"account_number\": \"\",\n \"account_type\": \"\",\n \"bank_code\": \"\",\n \"bank_name\": \"\",\n \"branch_code\": \"\",\n \"created_at\": \"\",\n \"iban\": \"\",\n \"primary\": \"\",\n \"status\": \"\",\n \"swift\": \"\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "4f703f6b-6322-4b03-870b-0eec4f91a752", + "name": "Unauthorized", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "merchants", + ":merchant_code", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "25fb4c85-69a1-40ae-96c3-759de7b503ae", + "name": "Forbidden", + "originalRequest": { + "url": { + "path": [ + "v1.1", + "merchants", + ":merchant_code", + "bank-accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "If true only the primary bank account (the one used for payouts) will be returned.", + "type": "text/plain" + }, + "key": "primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"error_message\": \"\",\n \"status_code\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "API Keys", + "description": "API Keys allow your application to gain programmatic access to SumUp.\nAPI Keys allow application to do authorized requests within the SumUp ecosystem. API Keys are scopes to single account and thus can't be used for endpoints where user presence is needed (for such endpoints it is necessary to use OAuth2).\n", + "item": [ + { + "id": "fd87654b-c67d-4411-8fbd-166258573403", + "name": "List API keys", + "request": { + "name": "List API keys", + "description": { + "content": "Returns paginated list of API keys.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Offset of the first key to return.", + "type": "text/plain" + }, + "key": "offset", + "value": "0" + }, + { + "disabled": false, + "description": { + "content": "Maximum number of keys to return.", + "type": "text/plain" + }, + "key": "limit", + "value": "10" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "4a3343df-d495-427c-90b5-3220a9bab69e", + "name": "List of API keys.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Offset of the first key to return.", + "type": "text/plain" + }, + "key": "offset", + "value": "0" + }, + { + "disabled": false, + "description": { + "content": "Maximum number of keys to return.", + "type": "text/plain" + }, + "key": "limit", + "value": "10" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"scopes\": [\n \"accounting.write\",\n \"user.profile\"\n ],\n \"preview\": \"\",\n \"type\": \"secret\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"plaintext\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"scopes\": [\n \"accounting.read\",\n \"invoices.read\"\n ],\n \"preview\": \"\",\n \"type\": \"public\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"plaintext\": \"\"\n }\n ],\n \"total_count\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "5148a729-ca26-432d-8eaa-aec8326e0ebe", + "name": "Create an API key", + "request": { + "name": "Create an API key", + "description": { + "content": "Creates a new API key for the user.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"\",\n \"scopes\": [\n \"email\",\n \"accounting.read\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "60de8737-f869-4504-b4c0-0eabf58162af", + "name": "Created API key.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"\",\n \"scopes\": [\n \"email\",\n \"accounting.read\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"scopes\": [\n \"accounting.write\",\n \"profile\"\n ],\n \"preview\": \"\",\n \"type\": \"secret\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"plaintext\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "4534fff0-db92-461e-bb35-2d0455e17bd0", + "name": "Revoke an API key", + "request": { + "name": "Revoke an API key", + "description": { + "content": "Revokes an API key.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "key_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "a1cffa36-f375-4f61-a516-f9bceb368b3a", + "name": "Successful revocation.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "DELETE", + "body": {} + }, + "status": "No Content", + "code": 204, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "3d366e76-f810-4698-9bbc-8a9637ec9e6d", + "name": "Retrieve an API Key", + "request": { + "name": "Retrieve an API Key", + "description": { + "content": "Gets an API key.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "key_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "dfaa2b47-66a3-4855-9e4b-920ab4797d56", + "name": "API key.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"scopes\": [\n \"accounting.write\",\n \"profile\"\n ],\n \"preview\": \"\",\n \"type\": \"secret\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"plaintext\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "d91d2dae-6d19-41fa-9cda-bc308a489d6f", + "name": "Update an API key", + "request": { + "name": "Update an API key", + "description": { + "content": "Updates an API key.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "key_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"\",\n \"scopes\": [\n \"accounting.read\",\n \"readers.write\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "4091f625-e523-4821-860e-20412ad884a8", + "name": "Successful update.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "api-keys", + ":key_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"\",\n \"scopes\": [\n \"accounting.read\",\n \"readers.write\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "No Content", + "code": 204, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Subaccounts", + "description": "Endpoints for managing merchant sub-accounts (operators).\n", + "item": [ + { + "id": "85d322be-d72d-49b6-8b95-cb3d822e8185", + "name": "List operators.", + "request": { + "name": "List operators.", + "description": { + "content": "Returns list of operators for currently authorized user's merchant.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Search query used to filter users that match given query term.\n\nCurrent implementation allow querying only over the email address.\nAll operators whos email address contains the query string are returned.\n", + "type": "text/plain" + }, + "key": "query", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "If true the list of operators will include also the primary user.", + "type": "text/plain" + }, + "key": "include_primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "bf37f0f7-2a84-465d-b5d7-53c4eaa037aa", + "name": "List of operators.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Search query used to filter users that match given query term.\n\nCurrent implementation allow querying only over the email address.\nAll operators whos email address contains the query string are returned.\n", + "type": "text/plain" + }, + "key": "query", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "If true the list of operators will include also the primary user.", + "type": "text/plain" + }, + "key": "include_primary", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[\n {\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"operator\",\n \"nickname\": \"\"\n },\n {\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n }\n]", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "a39f869d-8da4-417a-8a4e-776674def39b", + "name": "Create operator.", + "request": { + "name": "Create operator.", + "description": { + "content": "Creates new operator for currently authorized users' merchant.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"username\": \"\",\n \"password\": \"\",\n \"nickname\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "88e6eea9-a152-4b99-83f8-accc6f3c834b", + "name": "Newly created operator.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"username\": \"\",\n \"password\": \"\",\n \"nickname\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "34a433e0-30ab-49fd-a558-8bcd5b68a36b", + "name": "error response for compat API calls", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"username\": \"\",\n \"password\": \"\",\n \"nickname\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "690cc09f-1185-4fbf-b82c-a96859ec2157", + "name": "Disable operator.", + "request": { + "name": "Disable operator.", + "description": {}, + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "operator_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "097fa8de-2beb-4b70-b5bc-254e51296d4b", + "name": "Operator successfully disabled.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "DELETE", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "d4e7243c-c227-4fbb-86fa-302f95339018", + "name": "Get operator", + "request": { + "name": "Get operator", + "description": { + "content": "Returns specific operator.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "operator_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "abb70cca-2577-4615-b3db-a6da9cc8d82a", + "name": "Operator.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "d05f470a-6439-4bfb-8371-183b163f8497", + "name": "Update operator.", + "request": { + "name": "Update operator.", + "description": { + "content": "Updates operator. If the operator was disabled and their password is updated they will be unblocked.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "operator_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"disabled\": \"\",\n \"nickname\": \"\",\n \"password\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n },\n \"username\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "357fae09-ebdb-43fa-8025-c2618203d783", + "name": "Updated operator.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"disabled\": \"\",\n \"nickname\": \"\",\n \"password\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n },\n \"username\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "a763dcd2-5309-45cf-aa06-1e0b4c316f1f", + "name": "Invalid Operators' email or password was already used.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"disabled\": \"\",\n \"nickname\": \"\",\n \"password\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\"\n },\n \"username\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "39258134-54b6-4e49-9f6c-34ccdfc72071", + "name": "Disable operator.", + "request": { + "name": "Disable operator.", + "description": {}, + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id", + "disable" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "operator_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "754745be-7944-4f89-8da4-2c928d5527ce", + "name": "Operator successfully disabled.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id", + "disable" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "38d226e5-0893-4649-83c9-b9f83ee4a265", + "name": "Change operators password.", + "request": { + "name": "Change operators password.", + "description": { + "content": "Changes operators password, if the operator was disabled they will be unblocked.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id", + "reset" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "operator_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "0f797ec1-3e24-4642-8d90-7332207878fb", + "name": "Operators' password successfully changed.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id", + "reset" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"disabled\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"permissions\": {\n \"create_moto_payments\": \"\",\n \"create_referral\": \"\",\n \"full_transaction_history_view\": \"\",\n \"refund_transactions\": \"\",\n \"admin\": \"\"\n },\n \"account_type\": \"normal\",\n \"nickname\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "0c90f670-46b9-4713-8bcf-076f82e78d61", + "name": "Operators' password was already used.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "me", + "accounts", + ":operator_id", + "reset" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"error_code\": \"\",\n \"message\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Members", + "description": "Endpoints to manage account members. Members are users that have membership within merchant accounts.\n", + "item": [ + { + "id": "fa34ee92-bb17-4dec-aece-6274033d9eef", + "name": "List members", + "request": { + "name": "List members", + "description": { + "content": "Lists merchant members with their roles and permissions.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Offset of the first member to return.", + "type": "text/plain" + }, + "key": "offset", + "value": "0" + }, + { + "disabled": false, + "description": { + "content": "Maximum number of member to return.", + "type": "text/plain" + }, + "key": "limit", + "value": "10" + }, + { + "disabled": false, + "description": { + "content": "Indicates to skip count query.", + "type": "text/plain" + }, + "key": "scroll", + "value": "false" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by email address prefix.", + "type": "text/plain" + }, + "key": "email", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned members by the membership status.", + "type": "text/plain" + }, + "key": "status", + "value": "pending" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by role.", + "type": "text/plain" + }, + "key": "roles", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by role.", + "type": "text/plain" + }, + "key": "roles", + "value": "" + } + ], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "8b7df77b-504d-4d0f-91cc-858aa92cf0d6", + "name": "List of members.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Offset of the first member to return.", + "type": "text/plain" + }, + "key": "offset", + "value": "0" + }, + { + "disabled": false, + "description": { + "content": "Maximum number of member to return.", + "type": "text/plain" + }, + "key": "limit", + "value": "10" + }, + { + "disabled": false, + "description": { + "content": "Indicates to skip count query.", + "type": "text/plain" + }, + "key": "scroll", + "value": "false" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by email address prefix.", + "type": "text/plain" + }, + "key": "email", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned members by the membership status.", + "type": "text/plain" + }, + "key": "status", + "value": "pending" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by role.", + "type": "text/plain" + }, + "key": "roles", + "value": "" + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"status\": \"disabled\",\n \"attributes\": {\n \"minim_9a\": \"dolore Ut occaecat fugiat quis\",\n \"aliquip_fbd\": \"elit labore\"\n },\n \"invite\": {\n \"email\": \"\",\n \"expires_at\": \"\"\n },\n \"metadata\": {\n \"laborum6\": \"ad minim sed esse pariatur\",\n \"veniamb_\": \"est ut Ut anim\",\n \"sitb4\": \"elit Duis eiusmod ullamco\"\n },\n \"user\": {\n \"id\": \"\",\n \"email\": \"\",\n \"mfa_on_login_enabled\": \"\",\n \"virtual_user\": \"\",\n \"classic\": {\n \"user_id\": \"\"\n },\n \"disabled_at\": \"\",\n \"nickname\": \"\",\n \"picture\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"status\": \"pending\",\n \"attributes\": {\n \"ut_e9\": \"sed in nostrud deserunt\",\n \"laborume\": \"eu irure nostrud\"\n },\n \"invite\": {\n \"email\": \"\",\n \"expires_at\": \"\"\n },\n \"metadata\": {\n \"occaecat4\": \"ut voluptate exercitation cillum\",\n \"commodo_5_1\": \"ea Excepteur occaecat dolor\"\n },\n \"user\": {\n \"id\": \"\",\n \"email\": \"\",\n \"mfa_on_login_enabled\": \"\",\n \"virtual_user\": \"\",\n \"classic\": {\n \"user_id\": \"\"\n },\n \"disabled_at\": \"\",\n \"nickname\": \"\",\n \"picture\": \"\"\n }\n }\n ],\n \"total_count\": \"\"\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "24382fd7-9051-4753-93ce-39af6bf2a22b", + "name": "Merchant not found.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "description": { + "content": "Offset of the first member to return.", + "type": "text/plain" + }, + "key": "offset", + "value": "0" + }, + { + "disabled": false, + "description": { + "content": "Maximum number of member to return.", + "type": "text/plain" + }, + "key": "limit", + "value": "10" + }, + { + "disabled": false, + "description": { + "content": "Indicates to skip count query.", + "type": "text/plain" + }, + "key": "scroll", + "value": "false" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by email address prefix.", + "type": "text/plain" + }, + "key": "email", + "value": "" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned members by the membership status.", + "type": "text/plain" + }, + "key": "status", + "value": "pending" + }, + { + "disabled": false, + "description": { + "content": "Filter the returned users by role.", + "type": "text/plain" + }, + "key": "roles", + "value": "" + } + ], + "variable": [] + }, + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "8cdea3f5-3af8-4db6-b910-27c9cb8c9e7d", + "name": "Add member to merchant.", + "request": { + "name": "Add member to merchant.", + "description": {}, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"email\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"attributes\": {\n \"commodo_d2\": \"laborum dolore ipsum\"\n },\n \"is_managed_user\": \"\",\n \"metadata\": {\n \"ex_d\": \"voluptate reprehenderit Duis irure do\",\n \"sit_4\": \"commodo eiusmod\",\n \"deserunt_7\": \"ad qui id\"\n },\n \"nickname\": \"\",\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "8653eafd-1999-473f-b482-50e7af628e19", + "name": "Member created.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"email\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"attributes\": {\n \"commodo_d2\": \"laborum dolore ipsum\"\n },\n \"is_managed_user\": \"\",\n \"metadata\": {\n \"ex_d\": \"voluptate reprehenderit Duis irure do\",\n \"sit_4\": \"commodo eiusmod\",\n \"deserunt_7\": \"ad qui id\"\n },\n \"nickname\": \"\",\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"status\": \"pending\",\n \"attributes\": {\n \"laborumb76\": \"anim Excepteur\"\n },\n \"invite\": {\n \"email\": \"\",\n \"expires_at\": \"\"\n },\n \"metadata\": {\n \"irure_2\": \"ea ut\"\n },\n \"user\": {\n \"id\": \"\",\n \"email\": \"\",\n \"mfa_on_login_enabled\": \"\",\n \"virtual_user\": \"\",\n \"classic\": {\n \"user_id\": \"\"\n },\n \"disabled_at\": \"\",\n \"nickname\": \"\",\n \"picture\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "92dd5363-7d0b-43ba-85f6-4c32da4c4a30", + "name": "Invalid request.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"email\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"attributes\": {\n \"commodo_d2\": \"laborum dolore ipsum\"\n },\n \"is_managed_user\": \"\",\n \"metadata\": {\n \"ex_d\": \"voluptate reprehenderit Duis irure do\",\n \"sit_4\": \"commodo eiusmod\",\n \"deserunt_7\": \"ad qui id\"\n },\n \"nickname\": \"\",\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "53a2d70a-4e26-4422-a038-05d468c52fce", + "name": "Merchant not found.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"email\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"attributes\": {\n \"commodo_d2\": \"laborum dolore ipsum\"\n },\n \"is_managed_user\": \"\",\n \"metadata\": {\n \"ex_d\": \"voluptate reprehenderit Duis irure do\",\n \"sit_4\": \"commodo eiusmod\",\n \"deserunt_7\": \"ad qui id\"\n },\n \"nickname\": \"\",\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "465dd531-9cc1-46ab-96db-a3d248b60136", + "name": "Too many invitations sent to that user. The limit is 10 requests per 5 minutes and the Retry-After header is set to the number of minutes until the reset of the limit.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"email\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"attributes\": {\n \"commodo_d2\": \"laborum dolore ipsum\"\n },\n \"is_managed_user\": \"\",\n \"metadata\": {\n \"ex_d\": \"voluptate reprehenderit Duis irure do\",\n \"sit_4\": \"commodo eiusmod\",\n \"deserunt_7\": \"ad qui id\"\n },\n \"nickname\": \"\",\n \"password\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Too Many Requests", + "code": 429, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "cf9ff905-9436-49d3-bf74-7796fce71117", + "name": "Delete member", + "request": { + "name": "Delete member", + "description": { + "content": "Deletes member by ID.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "member_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "30535cb0-ec01-4b6a-a7d1-bb2f9337ebc1", + "name": "Member deleted.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "DELETE", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "b2484de9-8a74-4d1d-a9b6-932358fbd02a", + "name": "Merchant or member not found.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "DELETE", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "a8f9af1a-dea7-4340-b70f-a5b26faaae3a", + "name": "Get merchant member", + "request": { + "name": "Get merchant member", + "description": { + "content": "Returns merchant member details.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "member_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "125c9e72-42fb-4053-8334-841691d1fdad", + "name": "Merchant member.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"status\": \"pending\",\n \"attributes\": {\n \"laborumb76\": \"anim Excepteur\"\n },\n \"invite\": {\n \"email\": \"\",\n \"expires_at\": \"\"\n },\n \"metadata\": {\n \"irure_2\": \"ea ut\"\n },\n \"user\": {\n \"id\": \"\",\n \"email\": \"\",\n \"mfa_on_login_enabled\": \"\",\n \"virtual_user\": \"\",\n \"classic\": {\n \"user_id\": \"\"\n },\n \"disabled_at\": \"\",\n \"nickname\": \"\",\n \"picture\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "fcc90e9b-68d2-4aa6-ac78-9a04032ec4df", + "name": "Merchant or member not found.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "d22b4de9-3ae9-45b6-837d-3a77973269dc", + "name": "Update merchant member", + "request": { + "name": "Update merchant member", + "description": { + "content": "Update assigned roles of the member.", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "member_id", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "fc67c810-7873-4aec-817c-ee0d2821cb7f", + "name": "Member updated.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"status\": \"pending\",\n \"attributes\": {\n \"laborumb76\": \"anim Excepteur\"\n },\n \"invite\": {\n \"email\": \"\",\n \"expires_at\": \"\"\n },\n \"metadata\": {\n \"irure_2\": \"ea ut\"\n },\n \"user\": {\n \"id\": \"\",\n \"email\": \"\",\n \"mfa_on_login_enabled\": \"\",\n \"virtual_user\": \"\",\n \"classic\": {\n \"user_id\": \"\"\n },\n \"disabled_at\": \"\",\n \"nickname\": \"\",\n \"picture\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "f1478ff3-22d6-46ec-9368-bb8a0f3acd28", + "name": "Cannot set password or nickname for an invited user.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "b700a264-d2ea-44fd-abdf-272c2dec7fc5", + "name": "Cannot change password for managed user. Password was already used before.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "c2b67c68-a678-4fc9-91fa-a2f26c066e92", + "name": "Merchant or member not found.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "b447fd17-1315-4650-a4d7-9737eb1a7219", + "name": "Cannot update member as some data conflict with existing members.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "members", + ":member_id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PUT", + "body": { + "mode": "raw", + "raw": "{\n \"attributes\": {\n \"ipsume69\": \"amet dolor\"\n },\n \"metadata\": {\n \"veniam9\": \"laborum commodo ullamco\",\n \"aute_8f\": \"magna\",\n \"non5_\": \"laboris\"\n },\n \"roles\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"nickname\": \"\",\n \"password\": \"\"\n }\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Conflict", + "code": 409, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + }, + { + "name": "Readers", + "description": "A reader represents a device that accepts payments. You can use the SumUp Solo to accept in-person payments.\n", + "item": [ + { + "id": "170256c0-753a-4a0b-bdd3-ace09995dc5c", + "name": "List Readers", + "request": { + "name": "List Readers", + "description": { + "content": "Returns list of all readers of the merchant.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "11fab4b5-564c-45e0-b87e-1456e05cabef", + "name": "List of readers\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"status\": \"unknown\",\n \"device\": {\n \"identifier\": \"\",\n \"model\": \"solo\"\n },\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"meta\": {\n \"cupidatatc\": \"esse nulla\",\n \"dolore_a7\": \"voluptate\",\n \"elit_437\": \"labore consectetur\",\n \"aliquip_e\": \"qui non est nisi\",\n \"consequat63\": \"minim\"\n }\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"status\": \"processing\",\n \"device\": {\n \"identifier\": \"\",\n \"model\": \"virtual-solo\"\n },\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"meta\": {\n \"id__\": \"veniam sint\",\n \"Excepteur_66\": \"consectetur laboris dolore non\",\n \"ea9ab\": \"sed occaecat aliqua eiusmod\",\n \"velit68\": \"exercitation\",\n \"tempor_5f3\": \"laborum ex\",\n \"esseac\": \"sint nisi consequat\",\n \"aliquip_62\": \"deserunt Excepteur ut aute commodo\",\n \"ex0d0\": \"amet consectetur commodo\",\n \"nisi_9\": \"et sit do\",\n \"incididunt7\": \"aute Ut id labore\",\n \"velitafc\": \"amet\",\n \"anim_0_\": \"in et dolor nisi\",\n \"Duis_68\": \"consectetur ea laboris\",\n \"commodo_bdb\": \"elit\",\n \"ad_5\": \"culpa non est\",\n \"laboris_9b\": \"occaecat amet dolore quis\",\n \"ullamco_4\": \"ex Ut aute\",\n \"amet8f\": \"cillum nisi\",\n \"ut_b\": \"nostrud ad anim ut\",\n \"in4\": \"Lorem dolore dolore deserunt\",\n \"officia_8\": \"consectetur nostrud anim\",\n \"qui_52e\": \"et Lorem ullamco\",\n \"eiusmod_f3d\": \"fugiat\",\n \"sunt8\": \"sit\",\n \"qui_71\": \"officia sit\",\n \"cupidatat_3\": \"eu mollit ei\"\n }\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "0de21186-ad12-46b0-b9b6-5092972887ba", + "name": "Create a Reader", + "request": { + "name": "Create a Reader", + "description": { + "content": "Create a new reader linked to the merchant account.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"pairing_code\": \"\",\n \"meta\": {\n \"consectetur_cd\": \"anim sed fugiat qui\",\n \"dolor3c9\": \"dolore reprehenderit mollit\",\n \"aliqua0\": \"sunt minim ipsum con\",\n \"voluptatee\": \"cupidatat ea Excepteur ut\",\n \"incididunt22\": \"do fugiat cupidatat laboris incididunt\",\n \"cillumb\": \"proident minim\",\n \"pariatur_0\": \"est velit\",\n \"adbb\": \"dolore\",\n \"deserunt_e72\": \"sunt consequat\",\n \"ullamco_e\": \"adip\",\n \"dolor_d3f\": \"aliqua\",\n \"Duis_0\": \"in\",\n \"in_2f\": \"ad non ullamco quis\",\n \"consectetur_3f\": \"occaecat non ex\",\n \"do12\": \"sint\",\n \"dolor_d2\": \"consequat\"\n },\n \"name\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "cc5f4a30-b4de-4832-9e99-7ceb5c27b41a", + "name": "The reader got created.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"pairing_code\": \"\",\n \"meta\": {\n \"consectetur_cd\": \"anim sed fugiat qui\",\n \"dolor3c9\": \"dolore reprehenderit mollit\",\n \"aliqua0\": \"sunt minim ipsum con\",\n \"voluptatee\": \"cupidatat ea Excepteur ut\",\n \"incididunt22\": \"do fugiat cupidatat laboris incididunt\",\n \"cillumb\": \"proident minim\",\n \"pariatur_0\": \"est velit\",\n \"adbb\": \"dolore\",\n \"deserunt_e72\": \"sunt consequat\",\n \"ullamco_e\": \"adip\",\n \"dolor_d3f\": \"aliqua\",\n \"Duis_0\": \"in\",\n \"in_2f\": \"ad non ullamco quis\",\n \"consectetur_3f\": \"occaecat non ex\",\n \"do12\": \"sint\",\n \"dolor_d2\": \"consequat\"\n },\n \"name\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"status\": \"expired\",\n \"device\": {\n \"identifier\": \"\",\n \"model\": \"solo\"\n },\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"meta\": {\n \"nisi_\": \"ullamco elit culpa ea in\",\n \"Excepteure29\": \"in eu incididunt\",\n \"anim_bf\": \"ad nisi occaecat Lorem enim\",\n \"ut_ccf\": \"cillum ullamc\",\n \"dolore_0d4\": \"Lorem ullamco eu exercitation\",\n \"non_c\": \"deserunt nulla mollit commodo\",\n \"mollit_f\": \"incididunt sint dolor eu\",\n \"mollit30\": \"magna culpa proident consectetur\",\n \"laboruma5\": \"quis laborum Excepteur consectetur anim\",\n \"quis5\": \"aliquip voluptate in ea\",\n \"Excepteur_d1a\": \"aliquip esse id\",\n \"Ut_ed5\": \"ut\",\n \"laborum_c7\": \"nulla reprehenderit mollit elit\",\n \"dolor_2bc\": \"consequat voluptat\",\n \"eu0d\": \"id cillum commodo\",\n \"aliqua97e\": \"cupidatat fugiat\",\n \"ea_2\": \"magna in ullamco\",\n \"sed_a\": \"qui labore non mollit\",\n \"consequat_1\": \"amet velit culpa dolore\",\n \"dolore_987\": \"quis esse Ut ut\",\n \"aliqua_23\": \"ut in\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "490cd2ee-c3f9-405c-9926-b50b8ba3b21b", + "name": "Delete a reader", + "request": { + "name": "Delete a reader", + "description": { + "content": "Deletes a Reader.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) The unique identifier of the reader.\n", + "type": "text/plain" + } + } + ] + }, + "method": "DELETE", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "67e65fb4-8534-4933-a57f-f1b0f18cffc0", + "name": "The reader got successfully deleted from the merchant account.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "DELETE", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "e553b5ee-d3e5-4ae2-a191-85e552ffe361", + "name": "Retrieve a Reader", + "request": { + "name": "Retrieve a Reader", + "description": { + "content": "Gets a Reader.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) The unique identifier of the reader.\n", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "disabled": false, + "description": { + "content": "Return the reader only if it has been modified after the specified timestamp given in the headers.\n\nTimestamps are accepted in the following formats:\n - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1).\n - RFC 3339: Used for timestamps in JSON payloads on this API.\n", + "type": "text/plain" + }, + "key": "If-Modified-Since", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "198fdaa7-d7f1-4d74-b6e3-ec0821e647a6", + "name": "Reader object got returned.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "disabled": false, + "description": { + "content": "Return the reader only if it has been modified after the specified timestamp given in the headers.\n\nTimestamps are accepted in the following formats:\n - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1).\n - RFC 3339: Used for timestamps in JSON payloads on this API.\n", + "type": "text/plain" + }, + "key": "If-Modified-Since", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"status\": \"expired\",\n \"device\": {\n \"identifier\": \"\",\n \"model\": \"solo\"\n },\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"meta\": {\n \"nisi_\": \"ullamco elit culpa ea in\",\n \"Excepteure29\": \"in eu incididunt\",\n \"anim_bf\": \"ad nisi occaecat Lorem enim\",\n \"ut_ccf\": \"cillum ullamc\",\n \"dolore_0d4\": \"Lorem ullamco eu exercitation\",\n \"non_c\": \"deserunt nulla mollit commodo\",\n \"mollit_f\": \"incididunt sint dolor eu\",\n \"mollit30\": \"magna culpa proident consectetur\",\n \"laboruma5\": \"quis laborum Excepteur consectetur anim\",\n \"quis5\": \"aliquip voluptate in ea\",\n \"Excepteur_d1a\": \"aliquip esse id\",\n \"Ut_ed5\": \"ut\",\n \"laborum_c7\": \"nulla reprehenderit mollit elit\",\n \"dolor_2bc\": \"consequat voluptat\",\n \"eu0d\": \"id cillum commodo\",\n \"aliqua97e\": \"cupidatat fugiat\",\n \"ea_2\": \"magna in ullamco\",\n \"sed_a\": \"qui labore non mollit\",\n \"consequat_1\": \"amet velit culpa dolore\",\n \"dolore_987\": \"quis esse Ut ut\",\n \"aliqua_23\": \"ut in\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "c590c68e-7dba-434c-acd0-63eabc640411", + "name": "Malformed request.", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "disabled": false, + "description": { + "content": "Return the reader only if it has been modified after the specified timestamp given in the headers.\n\nTimestamps are accepted in the following formats:\n - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1).\n - RFC 3339: Used for timestamps in JSON payloads on this API.\n", + "type": "text/plain" + }, + "key": "If-Modified-Since", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Bad Request", + "code": 400, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "fd067c1e-deff-4bd9-bb0f-e37fb6666714", + "name": "The requested Reader resource does not exists.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "disabled": false, + "description": { + "content": "Return the reader only if it has been modified after the specified timestamp given in the headers.\n\nTimestamps are accepted in the following formats:\n - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1).\n - RFC 3339: Used for timestamps in JSON payloads on this API.\n", + "type": "text/plain" + }, + "key": "If-Modified-Since", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "c490b290-f68d-408c-be88-8732831f237f", + "name": "Update a Reader", + "request": { + "name": "Update a Reader", + "description": { + "content": "Updates a Reader.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) The unique identifier of the reader.\n", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PATCH", + "body": { + "mode": "raw", + "raw": "{\n \"meta\": {\n \"anima5\": \"pariatur Ut cupidatat\",\n \"aliquip_f5\": \"Lorem non\",\n \"ea_7e\": \"nisi cupidatat\",\n \"dolor62a\": \"deserunt amet ad voluptate cillum\",\n \"ut_d8\": \"pariatur dolore\",\n \"dolor5\": \"veniam Lorem ea enim\",\n \"nulla_10\": \"aliqua nisi aliquip\",\n \"Ut9\": \"ipsum deserunt consectetur\",\n \"anim2f\": \"occaecat nostrud laboris dolore quis\",\n \"eu_cf7\": \"mollit\",\n \"velit_f2\": \"ea dolore\",\n \"ipsum_58f\": \"eu mollit veniam\",\n \"anim0\": \"amet Lorem in tempor\",\n \"laboris3\": \"anim ut do\",\n \"minim_25\": \"sit consectetur in\",\n \"elit_bb1\": \"co\",\n \"magna_4d5\": \"Duis tempor laborum\",\n \"ipsum___\": \"commodo proident incididunt fugiat\",\n \"exb\": \"irure proident pariatur sed in\",\n \"Lorem_4\": \"id fugiat in Lorem\",\n \"anim_\": \"tempor ullamco nisi veniam\",\n \"eiusmod85f\": \"commodo irure cillum consequat\",\n \"doloree\": \"qui amet\",\n \"irureb\": \"sed dolore\",\n \"voluptate_4be\": \"ipsum cupidatat non laborum eiusmod\",\n \"sunt_ae2\": \"non ea aute occaecat\",\n \"anim_d\": \"deserunt proident veniam ex\",\n \"Lorem0e2\": \"consequat cillum labore sit\",\n \"magnad63\": \"dolor sunt\",\n \"dolore3\": \"in\",\n \"euf4f\": \"id non\",\n \"id_6\": \"consequat sed\",\n \"ina\": \"dolore voluptate consequat\",\n \"ullamco_6_\": \"in nulla amet sit\",\n \"dolorec8\": \"proide\",\n \"veniamd2\": \"sit laborum\",\n \"velit_773\": \"Excepteur veniam nostrud sit\",\n \"in3\": \"Duis\",\n \"enim_88\": \"velit culpa dolore\",\n \"irure_feb\": \"est adipisicing\",\n \"anim50\": \"ipsum proident elit eiusmod\",\n \"commodo2f4\": \"ut aliqua eu\",\n \"in7f\": \"consectetur Excepteur\",\n \"cillum_06\": \"qui Excepteur anim tempor\",\n \"amet_3\": \"enim est veniam Ut\",\n \"esse_88\": \"aute sed\",\n \"voluptateb\": \"in quis consectetur\"\n },\n \"name\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "c6cc5652-1a16-45c7-87db-30e9933a7531", + "name": "The update request was successful, but the reader didn't get updated.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PATCH", + "body": { + "mode": "raw", + "raw": "{\n \"meta\": {\n \"anima5\": \"pariatur Ut cupidatat\",\n \"aliquip_f5\": \"Lorem non\",\n \"ea_7e\": \"nisi cupidatat\",\n \"dolor62a\": \"deserunt amet ad voluptate cillum\",\n \"ut_d8\": \"pariatur dolore\",\n \"dolor5\": \"veniam Lorem ea enim\",\n \"nulla_10\": \"aliqua nisi aliquip\",\n \"Ut9\": \"ipsum deserunt consectetur\",\n \"anim2f\": \"occaecat nostrud laboris dolore quis\",\n \"eu_cf7\": \"mollit\",\n \"velit_f2\": \"ea dolore\",\n \"ipsum_58f\": \"eu mollit veniam\",\n \"anim0\": \"amet Lorem in tempor\",\n \"laboris3\": \"anim ut do\",\n \"minim_25\": \"sit consectetur in\",\n \"elit_bb1\": \"co\",\n \"magna_4d5\": \"Duis tempor laborum\",\n \"ipsum___\": \"commodo proident incididunt fugiat\",\n \"exb\": \"irure proident pariatur sed in\",\n \"Lorem_4\": \"id fugiat in Lorem\",\n \"anim_\": \"tempor ullamco nisi veniam\",\n \"eiusmod85f\": \"commodo irure cillum consequat\",\n \"doloree\": \"qui amet\",\n \"irureb\": \"sed dolore\",\n \"voluptate_4be\": \"ipsum cupidatat non laborum eiusmod\",\n \"sunt_ae2\": \"non ea aute occaecat\",\n \"anim_d\": \"deserunt proident veniam ex\",\n \"Lorem0e2\": \"consequat cillum labore sit\",\n \"magnad63\": \"dolor sunt\",\n \"dolore3\": \"in\",\n \"euf4f\": \"id non\",\n \"id_6\": \"consequat sed\",\n \"ina\": \"dolore voluptate consequat\",\n \"ullamco_6_\": \"in nulla amet sit\",\n \"dolorec8\": \"proide\",\n \"veniamd2\": \"sit laborum\",\n \"velit_773\": \"Excepteur veniam nostrud sit\",\n \"in3\": \"Duis\",\n \"enim_88\": \"velit culpa dolore\",\n \"irure_feb\": \"est adipisicing\",\n \"anim50\": \"ipsum proident elit eiusmod\",\n \"commodo2f4\": \"ut aliqua eu\",\n \"in7f\": \"consectetur Excepteur\",\n \"cillum_06\": \"qui Excepteur anim tempor\",\n \"amet_3\": \"enim est veniam Ut\",\n \"esse_88\": \"aute sed\",\n \"voluptateb\": \"in quis consectetur\"\n },\n \"name\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Not Modified", + "code": 304, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "3aa31957-1dda-4580-bb83-403a4bcd67de", + "name": "The reader is not linked to the merchant account.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "method": "PATCH", + "body": { + "mode": "raw", + "raw": "{\n \"meta\": {\n \"anima5\": \"pariatur Ut cupidatat\",\n \"aliquip_f5\": \"Lorem non\",\n \"ea_7e\": \"nisi cupidatat\",\n \"dolor62a\": \"deserunt amet ad voluptate cillum\",\n \"ut_d8\": \"pariatur dolore\",\n \"dolor5\": \"veniam Lorem ea enim\",\n \"nulla_10\": \"aliqua nisi aliquip\",\n \"Ut9\": \"ipsum deserunt consectetur\",\n \"anim2f\": \"occaecat nostrud laboris dolore quis\",\n \"eu_cf7\": \"mollit\",\n \"velit_f2\": \"ea dolore\",\n \"ipsum_58f\": \"eu mollit veniam\",\n \"anim0\": \"amet Lorem in tempor\",\n \"laboris3\": \"anim ut do\",\n \"minim_25\": \"sit consectetur in\",\n \"elit_bb1\": \"co\",\n \"magna_4d5\": \"Duis tempor laborum\",\n \"ipsum___\": \"commodo proident incididunt fugiat\",\n \"exb\": \"irure proident pariatur sed in\",\n \"Lorem_4\": \"id fugiat in Lorem\",\n \"anim_\": \"tempor ullamco nisi veniam\",\n \"eiusmod85f\": \"commodo irure cillum consequat\",\n \"doloree\": \"qui amet\",\n \"irureb\": \"sed dolore\",\n \"voluptate_4be\": \"ipsum cupidatat non laborum eiusmod\",\n \"sunt_ae2\": \"non ea aute occaecat\",\n \"anim_d\": \"deserunt proident veniam ex\",\n \"Lorem0e2\": \"consequat cillum labore sit\",\n \"magnad63\": \"dolor sunt\",\n \"dolore3\": \"in\",\n \"euf4f\": \"id non\",\n \"id_6\": \"consequat sed\",\n \"ina\": \"dolore voluptate consequat\",\n \"ullamco_6_\": \"in nulla amet sit\",\n \"dolorec8\": \"proide\",\n \"veniamd2\": \"sit laborum\",\n \"velit_773\": \"Excepteur veniam nostrud sit\",\n \"in3\": \"Duis\",\n \"enim_88\": \"velit culpa dolore\",\n \"irure_feb\": \"est adipisicing\",\n \"anim50\": \"ipsum proident elit eiusmod\",\n \"commodo2f4\": \"ut aliqua eu\",\n \"in7f\": \"consectetur Excepteur\",\n \"cillum_06\": \"qui Excepteur anim tempor\",\n \"amet_3\": \"enim est veniam Ut\",\n \"esse_88\": \"aute sed\",\n \"voluptateb\": \"in quis consectetur\"\n },\n \"name\": \"\"\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "e5939ae9-84d1-442c-be6a-3706fddd4a76", + "name": "Create a Reader Checkout", + "request": { + "name": "Create a Reader Checkout", + "description": { + "content": "Create a Checkout for a Reader.\n\nThis process is asynchronous and the actual transaction may take some time to be stared on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise checkout won't be accepted\n* After the checkout is accepted, the system has 60 seconds to start the payment on the target device. During this time, any other checkout for the same device will be rejected.\n\n**Note**: If the target device is a Solo, it must be in version 3.3.24.3 or higher.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) The unique identifier of the reader.\n", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + }, + "auth": null + }, + "response": [ + { + "id": "d802024e-a631-4de6-9e75-3d20e442ee84", + "name": "The Checkout got successfully created for the given reader.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Created", + "code": 201, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"data\": {\n \"client_transaction_id\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "92587003-d453-40fd-9100-9e535178007b", + "name": "Bad Request", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Request", + "code": 400, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "e99497e4-7299-4b5c-8564-405ac163f0d4", + "name": "Unprocessable Entity", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"commodo_a\": -33316468,\n \"deseruntfc\": 41900084,\n \"sunt_e8_\": \"incididunt\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "ee69b971-c3c5-44a9-9ea5-668da7e36233", + "name": "Internal Server Error", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Internal Server Error", + "code": 500, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "9acc9424-6a9d-49e0-9e71-8894599f112e", + "name": "Bad Gateway", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Bad Gateway", + "code": 502, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "cc93e85b-a56e-4de6-a2df-f059d7c4ea1f", + "name": "Gateway Timeout", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "checkout" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "{\n \"total_amount\": {\n \"value\": \"\",\n \"currency\": \"\",\n \"minor_unit\": \"\"\n },\n \"affiliate\": {\n \"app_id\": \"\",\n \"key\": \"\",\n \"foreign_transaction_id\": \"\",\n \"tags\": {\n \"voluptate48\": false,\n \"veniam_2d\": true\n }\n },\n \"card_type\": \"credit\",\n \"description\": \"\",\n \"installments\": \"\",\n \"return_url\": \"\",\n \"tip_rates\": [\n \"\",\n \"\"\n ]\n}", + "options": { + "raw": { + "headerFamily": "json", + "language": "json" + } + } + } + }, + "status": "Gateway Timeout", + "code": 504, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "id": "17bc27b2-c9df-4a99-b7c2-eba0966b95b5", + "name": "Create a Reader Terminate action", + "request": { + "name": "Create a Reader Terminate action", + "description": { + "content": "Create a Terminate action for a Reader.\n\nIt stops the current transaction on the target device.\n\nThis process is asynchronous and the actual termination may take some time to be performed on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise terminate won't be accepted\n* The action will succeed only if the device is waiting for cardholder action: e.g: waiting for card, waiting for PIN, etc.\n* There is no confirmation of the termination.\n\nIf a transaction is successfully terminated and `return_url` was provided on Checkout, the transaction status will be sent as `failed` to the provided URL.\n\n**Note**: If the target device is a Solo, it must be in version 3.3.28.0 or higher.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "type": "any", + "value": "", + "key": "merchant_code", + "disabled": false, + "description": { + "content": "(Required) ", + "type": "text/plain" + } + }, + { + "type": "any", + "value": "", + "key": "id", + "disabled": false, + "description": { + "content": "(Required) The unique identifier of the reader.\n", + "type": "text/plain" + } + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {}, + "auth": null + }, + "response": [ + { + "id": "f7149ebd-50f9-467d-9fff-3232a806681f", + "name": "The Terminate action was successfully dispatched for the given reader.\n", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "method": "POST", + "body": {} + }, + "status": "Accepted", + "code": 202, + "header": [], + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "id": "d3461596-2c53-4303-8b52-fc729ccbab5e", + "name": "Unprocessable Entity", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {} + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"commodo_a\": -33316468,\n \"deseruntfc\": 41900084,\n \"sunt_e8_\": \"incididunt\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "78ea3dad-1b9e-4d7b-b1a7-e02ecf8b06a7", + "name": "Internal Server Error", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {} + }, + "status": "Internal Server Error", + "code": 500, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "bb33cee2-15d8-4ed8-92cd-fdbae32ef4cf", + "name": "Bad Gateway", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {} + }, + "status": "Bad Gateway", + "code": 502, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "id": "35e31e13-4fe4-41e5-b174-d2bcb3d183df", + "name": "Gateway Timeout", + "originalRequest": { + "url": { + "path": [ + "v0.1", + "merchants", + ":merchant_code", + "readers", + ":id", + "terminate" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": {} + }, + "status": "Gateway Timeout", + "code": 504, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"errors\": {\n \"detail\": \"\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ] + } + ], + "event": [], + "variable": [ + { + "key": "baseUrl", + "value": "https://api.sumup.com" + } + ], + "info": { + "_postman_id": "407a6d68-59ad-4002-b61b-1e42149bf738", + "name": "SumUp REST API", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", + "description": { + "content": "SumUp’s REST API operates with `application/json` HTTP requests and response. The request bodies are sent through resource-oriented URLs and use the standard HTTP response codes.\nFor testing our APIs make sure you have a SumUp Profile (you can create one [here](https://me.sumup.com)). To activate your SumUp Profile [follow these steps](https://help.sumup.com/en-GB/articles/7gSOGSm2wEwIHyAvjitrLF).\n\nOnce you have an active SumUp Profile, go to [developer.sumup.com](https://developer.sumup.com/) and click on “Create” On the top right side, click on “Profile” followed by “Test profiles” Select your business country Click “Create” Copy and store safely the user name (format: 32 characters@developers.sumup.com) and randomly generated unique password.\n\nNote: You will not be able to access your password afterwards make sure to store it safely before dismissing the message\n\nNote: SumUp merchants are able to create up to 20 test profiles\n\nWhen you receive your test profile you can create your [client credentials](https://developer.sumup.com/docs/register-app/#3-create-oauth-client-credentials) and process different requests with real payment instruments, without charging them.\nLegal note: We reserve the right to change, modify, or remove the contents of this Website and SumUp APIs at any time without notice.\n", + "type": "text/plain" + } + } +} \ No newline at end of file diff --git a/openapi.json b/openapi.json new file mode 100755 index 0000000..abceda3 --- /dev/null +++ b/openapi.json @@ -0,0 +1 @@ +{"components":{"examples":{"CreatedReader":{"summary":"A reader that waits for the physical device to acknowledge the pairing.","value":{"created_at":"2023-05-09T14:50:20.214Z","device":{"identifier":"U1DT3NA00-CN","model":"solo"},"id":"rdr_3MSAFM23CK82VSTT4BN6RWSQ65","name":"Frontdesk","status":"processing","updated_at":"2023-05-09T14:52:58.714Z"}}},"links":{"DeleteReaderByID":{"description":"Delete the reader.\n","operationId":"DeleteReader","parameters":{"id":"$response.body#/id"}},"UpdateReaderByID":{"description":"Update the reader object. This can be used to set a name after using this endpoint to verify the pairing code.\n","operationId":"UpdateReader","parameters":{"id":"$response.body#/id"}}},"schemas":{"APIKey":{"properties":{"created_at":{"example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"},"id":{"description":"Unique identifier of the API Key.\n","example":"sup_pk_0D1FIpM6xqueY3L4Y994nseK0xMfOjPAU","type":"string"},"name":{"description":"User-assigned name of the API Key.","example":"My API Key","type":"string"},"plaintext":{"description":"The plaintext value of the API key. This field is returned only in the response to API key creation and is never again available in the plaintext form.\n","example":"sup_sk_LZFWoLydp6S4S4KQpGVs1POzzp6cL1vyZ","type":"string"},"preview":{"description":"Last 8 characters of the API key.\n","example":"p6cL1vyZ","type":"string"},"scopes":{"$ref":"#/components/schemas/OAuth2Scopes"},"type":{"enum":["public","secret"],"example":"secret","type":"string"},"updated_at":{"example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"}},"required":["id","name","scopes","preview","type","created_at","updated_at"],"title":"API Key","type":"object"},"APIKeysList":{"example":{"items":[{"created_at":"2023-03-24T10:10:10Z","id":"sup_pk_1tpmgizNLHMkx1DdKd2hdzorZAaf6AcZ9","name":"","preview":"Aaf6AcZ9","scopes":[],"type":"public","updated_at":"2023-03-24T10:10:10Z"},{"created_at":"2023-03-25T09:10:10Z","id":"sup_pk_0D1FIpM6xqueY3L4Y994nseK0xMfOjPAU","name":"Test Key","preview":"TGhqew1b","scopes":["transactions.history","user.app-settings","user.profile_readonly","user.profile","user.subaccounts","user.payout-settings","products","payments","payment_instruments","readers.read","readers.write"],"type":"secret","updated_at":"2023-03-25T09:10:10Z"}],"total_count":2},"properties":{"items":{"items":{"$ref":"#/components/schemas/APIKey"},"type":"array"},"total_count":{"type":"integer"}},"required":["items","total_count"],"type":"object"},"Account":{"description":"Profile information.","properties":{"type":{"description":"The role of the user.","enum":["normal","operator"],"type":"string"},"username":{"description":"Username of the user profile.","type":"string"}},"type":"object"},"Address":{"description":"Profile's personal address information.","properties":{"city":{"description":"City name from the address.","example":"Berlin","type":"string"},"country":{"description":"Two letter country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).","example":"DE","type":"string"},"line1":{"description":"First line of the address with details of the street name and number.","example":"Sample street","type":"string"},"line2":{"description":"Second line of the address with details of the building, unit, apartment, and floor numbers.","example":"ap. 5","type":"string"},"postal_code":{"description":"Postal code from the address.","example":"10115","type":"string"},"state":{"description":"State name or abbreviation from the address.","example":"Berlin","type":"string"}},"required":["country"],"type":"object"},"AddressWithDetails":{"description":"Details of the registered address.","properties":{"address_line1":{"description":"Address line 1","type":"string"},"address_line2":{"description":"Address line 2","type":"string"},"city":{"description":"City","type":"string"},"company":{"description":"undefined","type":"string"},"country":{"description":"Country ISO 3166-1 code","type":"string"},"country_details":{"$ref":"#/components/schemas/CountryDetails"},"first_name":{"description":"undefined","type":"string"},"landline":{"description":"Landline number","type":"string"},"last_name":{"description":"undefined","type":"string"},"post_code":{"description":"Postal code","type":"string"},"region_code":{"description":"Region code","type":"string"},"region_id":{"description":"Country region id","type":"number"},"region_name":{"description":"Region name","type":"string"},"state_id":{"description":"undefined","type":"string"},"timeoffset_details":{"$ref":"#/components/schemas/TimeoffsetDetails"}},"type":"object"},"Affiliate":{"description":"Affiliate metadata for the transaction.\nIt is an optional field that allow for integrators to track the source of the transaction.\n","properties":{"app_id":{"description":"Application ID of the affiliate.\nIt is a unique identifier for the application and should be set by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page.\n","example":"com.example.app","type":"string"},"foreign_transaction_id":{"description":"Foreign transaction ID of the affiliate.\nIt is a unique identifier for the transaction.\nIt can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get).\n","example":"123456","type":"string"},"key":{"description":"Key of the affiliate.\nIt is a unique identifier for the key and should be generated by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page.\n","example":"123e4567-e89b-12d3-a456-426614174000","format":"uuid","type":"string"},"tags":{"additionalProperties":true,"description":"Additional metadata for the transaction.\nIt is key-value object that can be associated with the transaction.\n","example":{},"type":"object"}},"required":["app_id","key","foreign_transaction_id"],"type":"object"},"AmountEvent":{"description":"Amount of the event.","format":"float","type":"number"},"AppSettings":{"description":"Mobile app settings","properties":{"advanced_mode":{"description":"Advanced mode.","type":"string"},"barcode_scanner":{"description":"Barcode scanner.","type":"string"},"cash_payment":{"description":"Cash payment.","type":"string"},"checkout_preference":{"description":"Checkout preference","type":"string"},"expected_max_transaction_amount":{"description":"Expected max transaction amount.","type":"number"},"include_vat":{"description":"Include vat.","type":"boolean"},"manual_entry":{"description":"Manual entry.","type":"string"},"manual_entry_tutorial":{"description":"Manual entry tutorial.","type":"boolean"},"mobile_payment":{"description":"Mobile payment.","type":"string"},"mobile_payment_tutorial":{"description":"Mobile payment tutorial.","type":"boolean"},"reader_payment":{"description":"Reader payment.","type":"string"},"referral":{"description":"Referral.","type":"string"},"tax_enabled":{"description":"Tax enabled.","type":"boolean"},"terminal_mode_tutorial":{"description":"Terminal mode tutorial.","type":"boolean"},"tip_rates":{"description":"Tip rates.","items":{"format":"float","type":"number"},"type":"array"},"tipping":{"description":"Tipping.","type":"string"}},"type":"object"},"Attributes":{"additionalProperties":{"maxLength":256},"description":"Object attributes that modifiable only by SumUp applications.","example":{},"type":"object"},"AuthToken":{"description":"Authorization token flow","properties":{"client_id":{"description":"The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app).","example":"fOcmczrYtYMJ7Li5GjMLLcUeC9dN","type":"string"},"client_secret":{"description":"The client secret of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app).","example":"717bd571b54297494cd7a79b491e8f2c1da6189c4cc2d3481380e8366eef539c","type":"string"},"code":{"description":"The authorization code that you received from requesting an authorization code.","example":"be366ce9fccd0c337d1da29b31d06dd1135ab95401562883","type":"string"},"grant_type":{"description":"The grant type used for obtaining an access token.","enum":["authorization_code","refresh_token"],"example":"refresh_token","type":"string"},"refresh_token":{"description":"A **required** parameter when generating a refresh token.","example":"d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af","type":"string"}},"required":["grant_type","client_id","client_secret","code"],"type":"object"},"BankAccount":{"properties":{"account_category":{"description":"Account category - business or personal","type":"string"},"account_holder_name":{"type":"string"},"account_number":{"description":"Account number","type":"string"},"account_type":{"description":"Type of the account","type":"string"},"bank_code":{"description":"Bank code","type":"string"},"bank_name":{"description":"Bank name","type":"string"},"branch_code":{"description":"Branch code","type":"string"},"created_at":{"description":"Creation date of the bank account","type":"string"},"iban":{"description":"IBAN","type":"string"},"primary":{"description":"The primary bank account is the one used for payouts","type":"boolean"},"status":{"description":"Status in the verification process","type":"string"},"swift":{"description":"SWIFT code","type":"string"}},"type":"object"},"BusinessOwners":{"description":"Business owners information.","items":{"properties":{"date_of_birth":{"description":"Date of birth","type":"string"},"first_name":{"description":"BO's first name","type":"string"},"landline":{"description":"BO's Landline","type":"string"},"last_name":{"description":"BO's last name of the user","type":"string"},"mobile_phone":{"description":"Mobile phone number","type":"string"},"ownership":{"description":"Ownership percentage","type":"number"}},"type":"object"},"type":"array"},"Card":{"description":"__Required when payment type is `card`.__ Details of the payment card.","properties":{"cvv":{"description":"Three or four-digit card verification value (security code) of the payment card.","example":"123","maxLength":4,"minLength":3,"type":"string","writeOnly":true},"expiry_month":{"description":"Month from the expiration time of the payment card. Accepted format is `MM`.","enum":["01","02","03","04","05","06","07","08","09","10","11","12"],"type":"string","writeOnly":true},"expiry_year":{"description":"Year from the expiration time of the payment card. Accepted formats are `YY` and `YYYY`.","example":"2023","maxLength":4,"minLength":2,"type":"string","writeOnly":true},"last_4_digits":{"description":"Last 4 digits of the payment card number.","example":"3456","maxLength":4,"minLength":4,"readOnly":true,"type":"string"},"name":{"description":"Name of the cardholder as it appears on the payment card.","example":"FIRSTNAME LASTNAME","type":"string","writeOnly":true},"number":{"description":"Number of the payment card (without spaces).","example":"1234567890123456","type":"string","writeOnly":true},"type":{"description":"Issuing card network of the payment card.","enum":["AMEX","CUP","DINERS","DISCOVER","ELO","ELV","HIPERCARD","JCB","MAESTRO","MASTERCARD","VISA","VISA_ELECTRON","VISA_VPAY","UNKNOWN"],"readOnly":true,"type":"string"},"zip_code":{"description":"Required five-digit ZIP code. Applicable only to merchant users in the USA.","example":"12345","maxLength":5,"minLength":5,"type":"string","writeOnly":true}},"required":["name","number","expiry_month","expiry_year","cvv","last_4_digits","type"],"type":"object"},"CardResponse":{"description":"Details of the payment card.","properties":{"last_4_digits":{"description":"Last 4 digits of the payment card number.","example":"3456","maxLength":4,"minLength":4,"readOnly":true,"type":"string"},"type":{"description":"Issuing card network of the payment card.","enum":["AMEX","CUP","DINERS","DISCOVER","ELO","ELV","HIPERCARD","JCB","MAESTRO","MASTERCARD","VISA","VISA_ELECTRON","VISA_VPAY","UNKNOWN"],"readOnly":true,"type":"string"}},"type":"object"},"Checkout":{"description":"Details of the payment checkout.","properties":{"amount":{"description":"Amount of the payment.","example":10.1,"format":"float","type":"number"},"checkout_reference":{"description":"Unique ID of the payment checkout specified by the client application when creating the checkout resource.","maxLength":90,"type":"string"},"currency":{"$ref":"#/components/schemas/Currency"},"customer_id":{"description":"Unique identification of a customer. If specified, the checkout session and payment instrument are associated with the referenced customer.","example":"831ff8d4cd5958ab5670","type":"string"},"date":{"description":"Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.","example":"2020-02-29T10:56:56+00:00","format":"date-time","type":"string"},"description":{"description":"Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.","type":"string"},"id":{"description":"Unique ID of the checkout resource.","example":"4e425463-3e1b-431d-83fa-1e51c2925e99","readOnly":true,"type":"string"},"mandate":{"$ref":"#/components/schemas/MandateResponse"},"merchant_code":{"description":"Unique identifying code of the merchant profile.","type":"string"},"pay_to_email":{"description":"Email address of the registered user (merchant) to whom the payment is made.","format":"email","type":"string"},"return_url":{"description":"URL to which the SumUp platform sends the processing status of the payment checkout.","format":"uri","type":"string"},"status":{"description":"Current status of the checkout.","enum":["PENDING","FAILED","PAID"],"type":"string"},"transactions":{"description":"List of transactions related to the payment.","items":{"allOf":[{"$ref":"#/components/schemas/TransactionMixinBase"},{"$ref":"#/components/schemas/TransactionMixinCheckout"}]},"type":"array","uniqueItems":true},"valid_until":{"description":"Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.","example":"2020-02-29T10:56:56+00:00","format":"date-time","nullable":true,"type":"string"}},"title":"Checkout","type":"object"},"CheckoutCreateRequest":{"description":"Details of the payment checkout.","properties":{"amount":{"description":"Amount of the payment.","format":"float","type":"number"},"checkout_reference":{"description":"Unique ID of the payment checkout specified by the client application when creating the checkout resource.","maxLength":90,"type":"string"},"currency":{"$ref":"#/components/schemas/Currency"},"customer_id":{"description":"Unique identification of a customer. If specified, the checkout session and payment instrument are associated with the referenced customer.","type":"string"},"date":{"description":"Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.","example":"2020-02-29T10:56:56+00:00","format":"date-time","readOnly":true,"type":"string"},"description":{"description":"Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.","type":"string"},"id":{"description":"Unique ID of the checkout resource.","readOnly":true,"type":"string"},"merchant_code":{"description":"Unique identifying code of the merchant profile.","type":"string"},"pay_to_email":{"description":"Email address of the registered user (merchant) to whom the payment is made. It is highly recommended to use `merchant_code` instead of `pay_to_email`.","format":"email","type":"string"},"payment_type":{"description":"Alternative payment method name","example":"boleto","type":"string"},"personal_details":{"description":"Object containing personal details about the payer, typical for __Boleto__ checkouts","properties":{"address":{"description":"Payer's address information","properties":{"city":{"description":"Payer's city","example":"Rio de Janeiro","type":"string"},"country":{"description":"Payer's country","example":"BR","type":"string"},"line_1":{"description":"Field for address details","type":"string"},"postal_code":{"description":"Payer's postal code. Must be eight digits long, however an optional dash could be applied after the 5th digit ([more information about the format available here](https://en.wikipedia.org/wiki/List_of_postal_codes_in_Brazil)). Both options are accepted as correct.","example":"20000-000","pattern":"^\\d{5}-?\\d{3}$","type":"string"},"state":{"description":"Payer's state code","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"],"example":"RJ","type":"string"}},"type":"object"},"email":{"description":"Payer's email address","example":"test@example.com","type":"string"},"first_name":{"description":"Payer's first name","example":"John","type":"string"},"last_name":{"description":"Payer's last name","example":"Doe","type":"string"},"tax_id":{"description":"Payer's tax identification number (CPF)","example":"423.378.593-47","type":"string"}},"type":"object"},"purpose":{"default":"CHECKOUT","description":"Purpose of the checkout.","enum":["CHECKOUT","SETUP_RECURRING_PAYMENT"],"type":"string"},"redirect_url":{"description":"__Required__ for [APMs](https://developer.sumup.com/online-payments/apm/introduction) and __recommended__ for card payments. Refers to a url where the end user is redirected once the payment processing completes. If not specified, the [Payment Widget](https://developer.sumup.com/online-payments/tools/card-widget) renders [3DS challenge](https://developer.sumup.com/online-payments/features/3ds) within an iframe instead of performing a full-page redirect.","example":"https://mysite.com/completed_purchase","type":"string"},"return_url":{"description":"URL to which the SumUp platform sends the processing status of the payment checkout.","format":"uri","type":"string"},"status":{"description":"Current status of the checkout.","enum":["PENDING","FAILED","PAID"],"readOnly":true,"type":"string"},"transactions":{"description":"List of transactions related to the payment.","items":{"allOf":[{"$ref":"#/components/schemas/TransactionMixinBase"},{"$ref":"#/components/schemas/TransactionMixinCheckout"}]},"readOnly":true,"type":"array","uniqueItems":true},"valid_until":{"description":"Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.","example":"2020-02-29T10:56:56+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"required":["checkout_reference","amount","currency","merchant_code"],"type":"object"},"CheckoutProcessMixin":{"description":"Details of the payment instrument for processing the checkout.","properties":{"card":{"$ref":"#/components/schemas/Card"},"customer_id":{"description":"__Required when `token` is provided.__ Unique ID of the customer.","type":"string"},"installments":{"description":"Number of installments for deferred payments. Available only to merchant users in Brazil.","maximum":12,"minimum":1,"type":"integer"},"mandate":{"$ref":"#/components/schemas/MandatePayload"},"payment_type":{"enum":["card","boleto","ideal","blik","bancontact"],"type":"string"},"token":{"description":"__Required when using a tokenized card to process a checkout.__ Unique token identifying the saved payment card for a customer.","type":"string"}},"required":["payment_type"],"type":"object"},"CheckoutSuccess":{"allOf":[{"$ref":"#/components/schemas/Checkout"},{"properties":{"merchant_name":{"description":"Name of the merchant","example":"Sample Merchant","type":"string"},"payment_instrument":{"description":"Object containing token information for the specified payment instrument","properties":{"token":{"description":"Token value","example":"e76d7e5c-9375-4fac-a7e7-b19dc5302fbc","type":"string"}},"type":"object"},"redirect_url":{"description":"Refers to a url where the end user is redirected once the payment processing completes.","example":"https://mysite.com/completed_purchase","type":"string"},"transaction_code":{"description":"Transaction code of the successful transaction with which the payment for the checkout is completed.","example":"TEENSK4W2K","readOnly":true,"type":"string"},"transaction_id":{"description":"Transaction ID of the successful transaction with which the payment for the checkout is completed.","example":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","readOnly":true,"type":"string"}},"type":"object"}]},"CompatError":{"description":"Error","properties":{"error_code":{"example":"NOT_FOUND","type":"string"},"message":{"example":"Resource not found.","type":"string"}},"required":["error_code","message"],"type":"object"},"CountryDetails":{"description":"Country Details","properties":{"currency":{"description":"Currency ISO 4217 code","type":"string"},"en_name":{"description":"Country EN name","type":"string"},"iso_code":{"description":"Country ISO code","type":"string"},"native_name":{"description":"Country native name","type":"string"}},"type":"object"},"CreateReaderCheckout":{"description":"Reader Checkout","properties":{"affiliate":{"$ref":"#/components/schemas/Affiliate"},"card_type":{"description":"The card type of the card used for the transaction.\nIs is required only for some countries (e.g: Brazil).\n","enum":["credit","debit"],"example":"credit","type":"string"},"description":{"description":"Description of the checkout to be shown in the Merchant Sales\n","type":"string"},"installments":{"description":"Number of installments for the transaction.\nIt may vary according to the merchant country.\nFor example, in Brazil, the maximum number of installments is 12.\n","example":1,"type":"integer"},"return_url":{"description":"Webhook URL to which the payment result will be sent.\nIt must be a HTTPS url.\n","example":"https://www.example.com","format":"uri","type":"string"},"tip_rates":{"description":"List of tipping rates to be displayed to the cardholder.\nThe rates are in percentage and should be between 0.01 and 0.99.\nThe list should be sorted in ascending order.\n","items":{"format":"float","multipleOf":0.01,"type":"number"},"type":"array"},"total_amount":{"$ref":"#/components/schemas/CreateReaderCheckoutAmount"}},"required":["total_amount"],"title":"Reader","type":"object"},"CreateReaderCheckoutAmount":{"description":"Amount of the transaction.\nThe amount is represented as an integer value altogether with the currency and the minor unit.\nFor example, EUR 1.00 is represented as value 100 with minor unit of 2.\n","properties":{"currency":{"description":"Currency ISO 4217 code","example":"EUR","type":"string"},"minor_unit":{"description":"The minor units of the currency. It represents the number of decimals of the currency.\nFor the currencies CLP, COP and HUF, the minor unit is 0.\n","example":2,"type":"integer"},"value":{"description":"Total amount of the transaction.\nIt must be a positive integer.\n","example":1000,"type":"integer"}},"required":["value","currency","minor_unit"],"type":"object"},"Currency":{"description":"Three-letter [ISO4217](https://en.wikipedia.org/wiki/ISO_4217) code of the currency for the amount. Currently supported currency values are enumerated above.","enum":["BGN","BRL","CHF","CLP","CZK","DKK","EUR","GBP","HRK","HUF","NOK","PLN","RON","SEK","USD"],"example":"EUR","type":"string"},"Customer":{"properties":{"customer_id":{"description":"Unique ID of the customer.","example":"831ff8d4cd5958ab5670","type":"string"},"personal_details":{"$ref":"#/components/schemas/PersonalDetails"}},"required":["customer_id"],"title":"Customer","type":"object"},"DetailsError":{"description":"Error message structure.","properties":{"details":{"description":"Details of the error.","type":"string"},"failed_constraints":{"items":{"properties":{"message":{"type":"string"},"reference":{"type":"string"}},"type":"object"},"type":"array"},"status":{"description":"The status code.","type":"number"},"title":{"description":"Short title of the error.","type":"string"}},"type":"object"},"DoingBusinessAs":{"description":"Doing Business As information","properties":{"address":{"properties":{"address_line1":{"description":"Address line 1","type":"string"},"address_line2":{"description":"Address line 2","type":"string"},"city":{"description":"City","type":"string"},"country":{"description":"Country ISO 3166-1 code","type":"string"},"post_code":{"description":"Postal code","type":"string"},"region_id":{"description":"Country region ID","type":"number"},"region_name":{"description":"Country region name","type":"string"}},"type":"object"},"business_name":{"description":"Doing business as name","type":"string"},"company_registration_number":{"description":"Doing business as company registration number","type":"string"},"email":{"description":"Doing business as email","type":"string"},"vat_id":{"description":"Doing business as VAT ID","type":"string"},"website":{"description":"Doing business as website","type":"string"}},"type":"object"},"Error":{"description":"Error message structure.","properties":{"error_code":{"description":"Platform code for the error.","type":"string"},"message":{"description":"Short description of the error.","type":"string"}},"type":"object"},"ErrorExtended":{"allOf":[{"$ref":"#/components/schemas/Error"},{"properties":{"param":{"description":"Parameter name (with relative location) to which the error applies. Parameters from embedded resources are displayed using dot notation. For example, `card.name` refers to the `name` parameter embedded in the `card` object.","type":"string"}},"type":"object"}]},"ErrorForbidden":{"description":"Error message for forbidden requests.","properties":{"error_code":{"description":"Platform code for the error.","type":"string"},"error_message":{"description":"Short description of the error.","type":"string"},"status_code":{"description":"HTTP status code for the error.","type":"string"}},"type":"object"},"Event":{"properties":{"amount":{"$ref":"#/components/schemas/AmountEvent"},"deducted_amount":{"description":"Amount deducted for the event.","format":"float","type":"number"},"deducted_fee_amount":{"description":"Amount of the fee deducted for the event.","format":"float","type":"number"},"fee_amount":{"description":"Amount of the fee related to the event.","format":"float","type":"number"},"id":{"$ref":"#/components/schemas/EventID"},"installment_number":{"description":"Consecutive number of the installment.","type":"integer"},"status":{"$ref":"#/components/schemas/EventStatus"},"timestamp":{"$ref":"#/components/schemas/TimestampEvent"},"transaction_id":{"$ref":"#/components/schemas/TransactionID"},"type":{"$ref":"#/components/schemas/EventType"}},"type":"object"},"EventID":{"description":"Unique ID of the transaction event.","format":"int64","type":"integer"},"EventStatus":{"description":"Status of the transaction event.","enum":["PENDING","SCHEDULED","FAILED","REFUNDED","SUCCESSFUL","PAID_OUT"],"type":"string"},"EventType":{"description":"Type of the transaction event.","enum":["PAYOUT","CHARGE_BACK","REFUND","PAYOUT_DEDUCTION"],"type":"string"},"FinancialPayouts":{"items":{"properties":{"amount":{"format":"float","type":"number"},"currency":{"type":"string"},"date":{"format":"date","type":"string"},"fee":{"format":"float","type":"number"},"id":{"type":"integer"},"reference":{"type":"string"},"status":{"enum":["SUCCESSFUL","FAILED"],"type":"string"},"transaction_code":{"type":"string"},"type":{"enum":["PAYOUT","CHARGE_BACK_DEDUCTION","REFUND_DEDUCTION","DD_RETURN_DEDUCTION","BALANCE_DEDUCTION"],"type":"string"}},"type":"object"},"title":"Financial Payouts","type":"array"},"HorizontalAccuracy":{"description":"Indication of the precision of the geographical position received from the payment terminal.","format":"float","type":"number"},"Invite":{"description":"Pending invitation for membership.\n","properties":{"email":{"description":"Email address of the invited user.","example":"boaty.mcboatface@sumup.com","format":"email","type":"string"},"expires_at":{"example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"}},"required":["email","expires_at"],"title":"Invite","type":"object"},"Lat":{"description":"Latitude value from the coordinates of the payment location (as received from the payment terminal reader).","format":"float","maximum":90,"minimum":0,"type":"number"},"LegalType":{"description":"Id of the legal type of the merchant profile","properties":{"description":{"description":"Legal type short description","type":"string"},"full_description":{"description":"Legal type description","type":"string"},"id":{"description":"Unique id","type":"number"},"sole_trader":{"description":"Sole trader legal type if true","type":"boolean"}},"type":"object"},"Link":{"description":"Details of a link to a related resource.","properties":{"href":{"description":"URL for accessing the related resource.","format":"uri","type":"string"},"rel":{"description":"Specifies the relation to the current resource.","type":"string"},"type":{"description":"Specifies the media type of the related resource.","type":"string"}},"type":"object"},"LinkRefund":{"allOf":[{"$ref":"#/components/schemas/Link"},{"properties":{"max_amount":{"description":"Maximum allowed amount for the refund.","format":"float","type":"number"},"min_amount":{"description":"Minimum allowed amount for the refund.","format":"float","type":"number"}},"type":"object"}]},"Lon":{"description":"Longitude value from the coordinates of the payment location (as received from the payment terminal reader).","format":"float","maximum":180,"minimum":0,"type":"number"},"MandatePayload":{"description":"Mandate is passed when a card is to be tokenized","example":{"type":"recurrent","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36","user_ip":"172.217.169.174"},"properties":{"type":{"description":"Indicates the mandate type","enum":["recurrent"],"type":"string"},"user_agent":{"description":"Operating system and web client used by the end-user","type":"string"},"user_ip":{"description":"IP address of the end user. Supports IPv4 and IPv6","type":"string"}},"required":["type","user_agent"],"type":"object"},"MandateResponse":{"description":"Created mandate","example":{"merchant_code":"MDASYTPD","status":"active","type":"recurrent"},"properties":{"merchant_code":{"description":"Merchant code which has the mandate","type":"string"},"status":{"description":"Mandate status","type":"string"},"type":{"description":"Indicates the mandate type","type":"string"}},"type":"object"},"Member":{"description":"A member is user within specific resource identified by resource id, resource type, and associated roles.\n","example":{"created_at":"2023-01-20T15:16:17Z","id":"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP","permissions":["members_read","members_write","create_moto_payments","full_transaction_history_view","refund_transactions","create_referral","developer_settings_edit","developer_settings_access"],"roles":["role_admin","role_owner"],"status":"accepted","updated_at":"2023-02-20T15:16:17Z","user":{"email":"example@sumup.com","id":"44ca0f5b-813b-46e1-aee7-e6242010662e","mfa_on_login_enabled":true,"virtual_user":false}},"properties":{"attributes":{"$ref":"#/components/schemas/Attributes"},"created_at":{"example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"},"id":{"description":"ID of the member.","example":"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP","type":"string"},"invite":{"$ref":"#/components/schemas/Invite"},"metadata":{"$ref":"#/components/schemas/Metadata"},"permissions":{"description":"User's permissions.","example":["members_read","members_write","create_moto_payments","full_transaction_history_view","refund_transactions","create_referral","developer_settings_edit","developer_settings_access"],"items":{"type":"string"},"type":"array"},"roles":{"description":"User's roles.","example":["role_admin"],"items":{"type":"string"},"type":"array"},"status":{"$ref":"#/components/schemas/MembershipStatus"},"updated_at":{"example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"},"user":{"$ref":"#/components/schemas/MembershipUser"}},"required":["id","roles","permissions","created_at","updated_at","status"],"title":"Member","type":"object"},"MembershipStatus":{"enum":["accepted","pending","expired","disabled","unknown"],"type":"string"},"MembershipUser":{"description":"User information.","properties":{"classic":{"$ref":"#/components/schemas/MembershipUserClassic"},"disabled_at":{"description":"Time when the user has been disabled. Applies only to virtual users (`virtual_user: true`).\n","format":"date-time","type":"string"},"email":{"description":"End-User's preferred e-mail address. Its value MUST conform to the RFC 5322 [RFC5322] addr-spec syntax. The RP MUST NOT rely upon this value being unique, for unique identification use ID instead.\n","example":"example@sumup.com","type":"string"},"id":{"description":"Identifier for the End-User (also called Subject).","example":"44ca0f5b-813b-46e1-aee7-e6242010662e","type":"string"},"mfa_on_login_enabled":{"description":"True if the user has enabled MFA on login.\n","example":true,"type":"boolean"},"nickname":{"description":"User's preferred name. Used for display purposes only.\n","example":"Test User","type":"string"},"picture":{"description":"URL of the End-User's profile picture. This URL refers to an image file (for example, a PNG, JPEG, or GIF image file), rather than to a Web page containing an image.\n","example":"https://usercontent.sumup.com/44ca0f5b-813b-46e1-aee7-e6242010662e.png","format":"uri","type":"string"},"virtual_user":{"description":"True if the user is a virtual user (operator).\n","example":false,"type":"boolean"}},"required":["id","email","mfa_on_login_enabled","virtual_user"],"type":"object"},"MembershipUserClassic":{"deprecated":true,"description":"Classic identifiers of the user.","properties":{"user_id":{"format":"int32","type":"integer"}},"required":["user_id"],"type":"object"},"MerchantAccount":{"description":"Details of the merchant account.","properties":{"account":{"$ref":"#/components/schemas/Account"},"app_settings":{"$ref":"#/components/schemas/AppSettings"},"is_migrated_payleven_br":{"description":"Merchant comes from payleven BR migration","type":"boolean"},"merchant_profile":{"$ref":"#/components/schemas/MerchantProfile"},"permissions":{"$ref":"#/components/schemas/Permissions"},"personal_profile":{"$ref":"#/components/schemas/PersonalProfile"}},"title":"Merchant Account","type":"object"},"MerchantProfile":{"description":"Account's merchant profile","properties":{"address":{"$ref":"#/components/schemas/AddressWithDetails"},"bank_accounts":{"items":{"$ref":"#/components/schemas/BankAccount"},"type":"array"},"business_owners":{"$ref":"#/components/schemas/BusinessOwners"},"company_name":{"description":"Company name","type":"string"},"company_registration_number":{"description":"Company registration number","type":"string"},"country":{"description":"Merchant country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) \u0026#40;for internal usage only\u0026#41;","type":"string"},"doing_business_as":{"$ref":"#/components/schemas/DoingBusinessAs"},"extdev":{"description":"True if the merchant is extdev","type":"boolean"},"legal_type":{"$ref":"#/components/schemas/LegalType"},"locale":{"description":"Merchant locale \u0026#40;for internal usage only\u0026#41;","type":"string"},"merchant_category_code":{"description":"Merchant category code","type":"string"},"merchant_code":{"description":"Unique identifying code of the merchant profile","type":"string"},"mobile_phone":{"description":"Mobile phone number","type":"string"},"nature_and_purpose":{"description":"Nature and purpose of the business","type":"string"},"payout_zone_migrated":{"description":"True if the payout zone of this merchant is migrated","type":"boolean"},"permanent_certificate_access_code":{"description":"Permanent certificate access code \u0026#40;Portugal\u0026#41;","type":"string"},"settings":{"$ref":"#/components/schemas/MerchantSettings"},"vat_id":{"description":"Vat ID","type":"string"},"vat_rates":{"$ref":"#/components/schemas/VatRates"},"website":{"description":"Website","type":"string"}},"type":"object"},"MerchantSettings":{"description":"Merchant settings \u0026#40;like \\\"payout_type\\\", \\\"payout_period\\\"\u0026#41;","properties":{"daily_payout_email":{"description":"Whether merchant will receive daily payout emails","type":"boolean"},"gross_settlement":{"description":"Whether merchant has gross settlement enabled","type":"boolean"},"monthly_payout_email":{"description":"Whether merchant will receive monthly payout emails","type":"boolean"},"moto_payment":{"description":"Whether merchant can make MOTO payments","enum":["UNAVAILABLE","ENFORCED","ON","OFF"],"type":"string"},"payout_instrument":{"description":"Payout Instrument","type":"string"},"payout_on_demand":{"description":"Whether merchant will receive payouts on demand","type":"boolean"},"payout_on_demand_available":{"description":"Whether merchant can edit payouts on demand","type":"boolean"},"payout_period":{"description":"Payout frequency","type":"string"},"payout_type":{"description":"Payout type","type":"string"},"printers_enabled":{"description":"Whether to show printers in mobile app","type":"boolean"},"stone_merchant_code":{"description":"Stone merchant code","type":"string"},"tax_enabled":{"description":"Whether to show tax in receipts \u0026#40;saved per transaction\u0026#41;","type":"boolean"}},"type":"object"},"Meta":{"additionalProperties":{"maxLength":256},"description":"Set of user-defined key-value pairs attached to the object.","example":{},"maxProperties":50,"type":"object"},"Metadata":{"additionalProperties":{"maxLength":256},"description":"Set of user-defined key-value pairs attached to the object. Partial updates are not supported. When updating, always submit whole metadata.","example":{},"type":"object"},"OAuth2Scopes":{"example":["invoices.read","invoices.write","products","user.app-settings"],"items":{"enum":["accounting.read","accounting.write","email","invoices.read","invoices.write","payment_instruments","payments","products","profile","readers.read","readers.write","transactions.history","user.app-settings","user.payout-settings","user.profile","user.profile_readonly","user.subaccounts"],"type":"string"},"maxItems":128,"type":"array"},"Operator":{"properties":{"account_type":{"enum":["operator","normal"],"type":"string"},"created_at":{"format":"date-time","type":"string"},"disabled":{"example":false,"type":"boolean"},"id":{"format":"int32","type":"integer"},"nickname":{"example":"Operator 1","nullable":true,"type":"string"},"permissions":{"$ref":"#/components/schemas/OperatorPermissions"},"updated_at":{"format":"date-time","type":"string"},"username":{"example":"operator1@mydomain.com","type":"string"}},"required":["id","username","disabled","created_at","updated_at","permissions","account_type"],"type":"object"},"OperatorPermissions":{"properties":{"admin":{"type":"boolean"},"create_moto_payments":{"type":"boolean"},"create_referral":{"type":"boolean"},"full_transaction_history_view":{"type":"boolean"},"refund_transactions":{"type":"boolean"}},"required":["create_moto_payments","create_referral","full_transaction_history_view","refund_transactions","admin"],"type":"object"},"PaymentInstrumentResponse":{"description":"Payment Instrument Response","example":{"active":true,"card":{"last_4_digits":"0001","type":"VISA"},"created_at":"2021-03-30T10:06:07.000+00:00","mandate":{"merchant_code":"MDASYTPD","status":"active","type":"recurrent"},"token":"bcfc8e5f-3b47-4cb9-854b-3b7a4cce7be3","type":"card"},"properties":{"active":{"default":true,"description":"Indicates whether the payment instrument is active and can be used for payments. To deactivate it, send a `DELETE` request to the resource endpoint.","readOnly":true,"type":"boolean"},"card":{"description":"Details of the payment card.","properties":{"last_4_digits":{"description":"Last 4 digits of the payment card number.","example":"3456","maxLength":4,"minLength":4,"readOnly":true,"type":"string"},"type":{"description":"Issuing card network of the payment card.","enum":["AMEX","CUP","DINERS","DISCOVER","ELO","ELV","HIPERCARD","JCB","MAESTRO","MASTERCARD","VISA","VISA_ELECTRON","VISA_VPAY","UNKNOWN"],"readOnly":true,"type":"string"}},"type":"object"},"created_at":{"description":"Creation date of payment instrument. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.","format":"date-time","type":"string"},"mandate":{"$ref":"#/components/schemas/MandateResponse"},"token":{"description":"Unique token identifying the saved payment card for a customer.","readOnly":true,"type":"string"},"type":{"description":"Type of the payment instrument.","enum":["card"],"type":"string"}},"type":"object"},"Permissions":{"description":"User permissions","properties":{"create_moto_payments":{"description":"Create MOTO payments","type":"boolean"},"create_referral":{"description":"Create referral","type":"boolean"},"full_transaction_history_view":{"description":"Can view full merchant transaction history","type":"boolean"},"refund_transactions":{"description":"Refund transactions","type":"boolean"}},"type":"object"},"PersonalDetails":{"description":"Personal details for the customer.","properties":{"address":{"$ref":"#/components/schemas/Address"},"birthdate":{"description":"Date of birth of the customer.","example":"1993-12-31","format":"date","type":"string"},"email":{"description":"Email address of the customer.","example":"user@example.com","type":"string"},"first_name":{"description":"First name of the customer.","example":"John","type":"string"},"last_name":{"description":"Last name of the customer.","example":"Doe","type":"string"},"phone":{"description":"Phone number of the customer.","example":"+491635559723","type":"string"}},"type":"object"},"PersonalProfile":{"description":"Account's personal profile.","properties":{"address":{"$ref":"#/components/schemas/AddressWithDetails"},"complete":{"type":"boolean"},"date_of_birth":{"description":"Date of birth","type":"string"},"first_name":{"description":"First name of the user","type":"string"},"last_name":{"description":"Last name of the user","type":"string"},"mobile_phone":{"description":"Mobile phone number","type":"string"}},"type":"object"},"Product":{"description":"Details of the product for which the payment is made.","properties":{"name":{"description":"Name of the product from the merchant's catalog.","type":"string"},"price":{"description":"Price of the product without VAT.","format":"float","type":"number"},"price_with_vat":{"description":"Price of a single product item with VAT.","format":"float","type":"number"},"quantity":{"description":"Number of product items for the purchase.","type":"number"},"single_vat_amount":{"description":"Amount of the VAT for a single product item (calculated as the product of `price` and `vat_rate`, i.e. `single_vat_amount = price * vat_rate`).","format":"float","type":"number"},"total_price":{"description":"Total price of the product items without VAT (calculated as the product of `price` and `quantity`, i.e. `total_price = price * quantity`).","format":"float","type":"number"},"total_with_vat":{"description":"Total price of the product items including VAT (calculated as the product of `price_with_vat` and `quantity`, i.e. `total_with_vat = price_with_vat * quantity`).","format":"float","type":"number"},"vat_amount":{"description":"Total VAT amount for the purchase (calculated as the product of `single_vat_amount` and `quantity`, i.e. `vat_amount = single_vat_amount * quantity`).","format":"float","type":"number"},"vat_rate":{"description":"VAT rate applicable to the product.","format":"float","type":"number"}},"type":"object"},"Reader":{"description":"A physical card reader device that can accept in-person payments.","properties":{"created_at":{"description":"Reader creation timestamp.","example":"2023-01-18T15:16:17Z","format":"date-time","type":"string"},"device":{"$ref":"#/components/schemas/ReaderDevice"},"id":{"$ref":"#/components/schemas/ReaderID"},"meta":{"$ref":"#/components/schemas/Meta"},"name":{"$ref":"#/components/schemas/ReaderName"},"status":{"$ref":"#/components/schemas/ReaderStatus"},"updated_at":{"description":"Reader last-modification timestamp.","example":"2023-01-20T15:16:17Z","format":"date-time","type":"string"}},"required":["id","name","status","device","created_at","updated_at"],"title":"Reader","type":"object"},"ReaderCheckoutStatusChange":{"description":"The callback payload containing the status change of the Reader Checkout.\n","properties":{"event_type":{"description":"The event type.","example":"solo.transaction.updated","type":"string"},"id":{"description":"The unique event id.","example":"123e4567-e89b-12d3-a456-426614174000","format":"uuid","type":"string"},"payload":{"description":"The event payload.","properties":{"client_transaction_id":{"description":"The unique client transaction id. It is the same returned by the Checkout.","example":"ba0a3c07-799e-40f8-89e9-1dfe96e4557e","format":"uuid","type":"string"},"merchant_code":{"description":"The target merchant code owner of the transaction.","example":"M1234567","type":"string"},"status":{"description":"The status of the transaction.","enum":["successful","failed"],"example":"successful","type":"string"},"transaction_id":{"deprecated":true,"description":"The unique transaction id.","example":"c88032e4-a384-4030-943c-ac59cc768d90","format":"uuid","type":"string"}},"required":["client_transaction_id","merchant_code","status"],"type":"object"},"timestamp":{"description":"The timestamp of the event.","example":"2021-01-01T00:00:00Z","format":"date-time","type":"string"}},"required":["id","event_type","payload","timestamp"],"type":"object"},"ReaderDevice":{"description":"Information about the underlying physical device.\n","properties":{"identifier":{"description":"A unique identifier of the physical device (e.g. serial number).","example":"U1DT3NA00-CN","type":"string"},"model":{"description":"Identifier of the model of the device.","enum":["solo","virtual-solo"],"example":"solo","type":"string"}},"required":["identifier","model"],"type":"object"},"ReaderID":{"description":"Unique identifier of the object.\n\nNote that this identifies the instance of the physical devices pairing with your SumUp account. \n\nIf you DELETE a reader, and pair the device again, the ID will be different. Do not use this ID to refer to a physical device.\n","example":"rdr_3MSAFM23CK82VSTT4BN6RWSQ65","maxLength":30,"minLength":30,"type":"string","x-go-type":"readers.ReaderID","x-go-type-import":{"path":"github.com/sumup/identity/apps/portier-backend/internal/domain/readers"}},"ReaderName":{"description":"Custom human-readable, user-defined name for easier identification of the reader.\n","example":"Frontdesk","maxLength":500,"type":"string"},"ReaderPairingCode":{"description":"The pairing code is a 8 or 9 character alphanumeric string that is displayed on a SumUp Device after initiating the pairing.\nIt is used to link the physical device to the created pairing.\n","example":"4WLFDSBF","maxLength":9,"minLength":8,"type":"string"},"ReaderStatus":{"description":"The status of the reader object gives information about the current state of the reader.\n\nPossible values:\n\n- `unknown` - The reader status is unknown.\n- `processing` - The reader is created and waits for the physical device to confirm the pairing.\n- `paired` - The reader is paired with a merchant account and can be used with SumUp APIs.\n- `expired` - The pairing is expired and no longer usable with the account. The resource needs to get recreated","enum":["unknown","processing","paired","expired"],"example":"paired","type":"string"},"Receipt":{"properties":{"acquirer_data":{"properties":{"authorization_code":{"type":"string"},"local_time":{"type":"string"},"return_code":{"type":"string"},"tid":{"type":"string"}},"type":"object"},"emv_data":{"type":"object"},"merchant_data":{"$ref":"#/components/schemas/ReceiptMerchantData"},"transaction_data":{"$ref":"#/components/schemas/ReceiptTransaction"}},"title":"Receipt","type":"object"},"ReceiptCard":{"properties":{"last_4_digits":{"description":"Card last 4 digits.","type":"string"},"type":{"description":"Card Scheme.","type":"string"}},"type":"object"},"ReceiptEvent":{"properties":{"amount":{"$ref":"#/components/schemas/AmountEvent"},"id":{"$ref":"#/components/schemas/EventID"},"receipt_no":{"type":"string"},"status":{"$ref":"#/components/schemas/EventStatus"},"timestamp":{"$ref":"#/components/schemas/TimestampEvent"},"transaction_id":{"$ref":"#/components/schemas/TransactionID"},"type":{"$ref":"#/components/schemas/EventType"}},"type":"object"},"ReceiptMerchantData":{"description":"Receipt merchant data","properties":{"locale":{"type":"string"},"merchant_profile":{"properties":{"address":{"properties":{"address_line1":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"country_en_name":{"type":"string"},"country_native_name":{"type":"string"},"landline":{"type":"string"},"post_code":{"type":"string"}},"type":"object"},"business_name":{"type":"string"},"email":{"type":"string"},"merchant_code":{"type":"string"}},"type":"object"}},"type":"object"},"ReceiptTransaction":{"description":"Transaction information.","properties":{"amount":{"description":"Transaction amount.","type":"string"},"card":{"$ref":"#/components/schemas/ReceiptCard"},"currency":{"description":"Transaction currency.","type":"string"},"entry_mode":{"description":"Transaction entry mode.","type":"string"},"events":{"description":"Events","items":{"$ref":"#/components/schemas/ReceiptEvent"},"type":"array"},"installments_count":{"description":"Number of installments.","type":"integer"},"payment_type":{"description":"Transaction type.","type":"string"},"products":{"description":"Products","items":{"properties":{"description":{"description":"Product description.","type":"string"},"name":{"description":"Product name.","type":"string"},"price":{"description":"Product price.","format":"float","type":"number"},"quantity":{"description":"Product quantity.","type":"integer"},"total_price":{"description":"Quantity x product price.","format":"float","type":"number"}},"type":"object"},"type":"array"},"receipt_no":{"description":"Receipt number","type":"string"},"status":{"description":"Transaction processing status.","type":"string"},"timestamp":{"description":"Time created at.","format":"date-time","type":"string"},"tip_amount":{"description":"Tip amount (included in transaction amount).","type":"string"},"transaction_code":{"description":"Transaction code.","type":"string"},"vat_amount":{"description":"Transaction VAT amount.","type":"string"},"vat_rates":{"description":"Vat rates.","items":{"properties":{"gross":{"description":"Gross","format":"float","type":"number"},"net":{"description":"Net","format":"float","type":"number"},"rate":{"description":"Rate","format":"float","type":"number"},"vat":{"description":"Vat","format":"float","type":"number"}},"type":"object"},"type":"array"},"verification_method":{"description":"Cardholder verification method.","type":"string"}},"type":"object"},"TimeoffsetDetails":{"description":"TimeOffset Details","properties":{"dst":{"description":"Daylight Saving Time","type":"boolean"},"offset":{"description":"UTC offset","type":"number"},"post_code":{"description":"Postal code","type":"string"}},"type":"object"},"TimestampEvent":{"description":"Date and time of the transaction event.","format":"date-time","type":"string"},"TransactionEvent":{"description":"Details of a transaction event.","properties":{"amount":{"$ref":"#/components/schemas/AmountEvent"},"date":{"description":"Date when the transaction event occurred.","format":"date","type":"string"},"due_date":{"description":"Date when the transaction event is due to occur.","format":"date","type":"string"},"event_type":{"$ref":"#/components/schemas/EventType"},"id":{"$ref":"#/components/schemas/EventID"},"installment_number":{"description":"Consecutive number of the installment that is paid. Applicable only payout events, i.e. `event_type = PAYOUT`.","type":"integer"},"status":{"$ref":"#/components/schemas/EventStatus"},"timestamp":{"$ref":"#/components/schemas/TimestampEvent"}},"type":"object"},"TransactionFull":{"allOf":[{"$ref":"#/components/schemas/TransactionMixinBase"},{"$ref":"#/components/schemas/TransactionMixinCheckout"},{"$ref":"#/components/schemas/TransactionMixinHistory"},{"properties":{"card":{"$ref":"#/components/schemas/CardResponse"},"events":{"description":"List of events related to the transaction.","items":{"$ref":"#/components/schemas/Event"},"type":"array","uniqueItems":true},"horizontal_accuracy":{"$ref":"#/components/schemas/HorizontalAccuracy"},"lat":{"$ref":"#/components/schemas/Lat"},"links":{"description":"List of hyperlinks for accessing related resources.","items":{"anyOf":[{"$ref":"#/components/schemas/Link"},{"$ref":"#/components/schemas/LinkRefund"}]},"type":"array","uniqueItems":true},"local_time":{"description":"Local date and time of the creation of the transaction.","format":"date-time","type":"string"},"location":{"description":"Details of the payment location as received from the payment terminal.","properties":{"horizontal_accuracy":{"$ref":"#/components/schemas/HorizontalAccuracy"},"lat":{"$ref":"#/components/schemas/Lat"},"lon":{"$ref":"#/components/schemas/Lon"}},"type":"object"},"lon":{"$ref":"#/components/schemas/Lon"},"payout_type":{"description":"Payout type for the transaction.","enum":["BANK_ACCOUNT","BALANCE","PREPAID_CARD"],"type":"string"},"products":{"description":"List of products from the merchant's catalogue for which the transaction serves as a payment.","items":{"$ref":"#/components/schemas/Product"},"type":"array"},"simple_payment_type":{"description":"Simple name of the payment type.","enum":["MOTO","CASH","CC_SIGNATURE","ELV","CC_CUSTOMER_ENTERED","MANUAL_ENTRY","EMV"],"type":"string"},"simple_status":{"description":"Status generated from the processing status and the latest transaction state.","enum":["SUCCESSFUL","PAID_OUT","CANCEL_FAILED","CANCELLED","CHARGEBACK","FAILED","REFUND_FAILED","REFUNDED","NON_COLLECTION"],"type":"string"},"tax_enabled":{"description":"Indicates whether tax deduction is enabled for the transaction.","type":"boolean"},"transaction_events":{"description":"List of transaction events related to the transaction.","items":{"$ref":"#/components/schemas/TransactionEvent"},"type":"array"},"username":{"description":"Email address of the registered user (merchant) to whom the payment is made.","format":"email","type":"string"},"vat_rates":{"description":"List of VAT rates applicable to the transaction.","items":{},"type":"array"},"verification_method":{"description":"Verification method used for the transaction.","enum":["none","signature","offline pin","online pin","offline pin + signature","confirmation code verified"],"type":"string"}},"type":"object"}]},"TransactionHistory":{"allOf":[{"$ref":"#/components/schemas/TransactionMixinBase"},{"$ref":"#/components/schemas/TransactionMixinHistory"},{"properties":{"card_type":{"description":"Issuing card network of the payment card used for the transaction.","enum":["VISA","AMEX","CUP","DINERS","DISCOVER","ELO","ELV","HIPERCARD","JCB","MAESTRO","MASTERCARD","VISA_ELECTRON","VISA_VPAY","UNKNOWN"],"type":"string"},"client_transaction_id":{"description":"Client-specific ID of the transaction.","type":"string"},"transaction_id":{"$ref":"#/components/schemas/TransactionID"},"type":{"description":"Type of the transaction for the registered user specified in the `user` property.","enum":["PAYMENT","REFUND","CHARGE_BACK"],"type":"string"},"user":{"description":"Email address of the registered user (merchant) to whom the payment is made.","format":"email","type":"string"}},"type":"object"}]},"TransactionID":{"description":"Unique ID of the transaction.","type":"string"},"TransactionMixinBase":{"description":"Details of the transaction.","properties":{"amount":{"description":"Total amount of the transaction.","example":10.1,"format":"float","type":"number"},"currency":{"$ref":"#/components/schemas/Currency"},"id":{"description":"Unique ID of the transaction.","example":"6b425463-3e1b-431d-83fa-1e51c2925e99","type":"string"},"installments_count":{"description":"Current number of the installment for deferred payments.","minimum":1,"type":"integer"},"payment_type":{"description":"Payment type used for the transaction.","enum":["ECOM","RECURRING","BOLETO"],"type":"string"},"status":{"description":"Current status of the transaction.","enum":["SUCCESSFUL","CANCELLED","FAILED","PENDING"],"type":"string"},"timestamp":{"description":"Date and time of the creation of the transaction. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.","example":"2020-02-29T10:56:56.876Z","format":"date-time","type":"string"},"transaction_code":{"description":"Transaction code returned by the acquirer/processing entity after processing the transaction.","example":"TEENSK4W2K","type":"string"}},"type":"object"},"TransactionMixinCheckout":{"properties":{"auth_code":{"description":"Authorization code for the transaction sent by the payment card issuer or bank. Applicable only to card payments.","example":"053201","type":"string"},"entry_mode":{"description":"Entry mode of the payment details.","enum":["CUSTOMER_ENTRY","BOLETO"],"type":"string"},"internal_id":{"description":"Internal unique ID of the transaction on the SumUp platform.","example":1763892018,"type":"integer"},"merchant_code":{"description":"Unique code of the registered merchant to whom the payment is made.","example":"MH4H92C7","type":"string"},"tip_amount":{"description":"Amount of the tip (out of the total transaction amount).","example":3,"format":"float","type":"number"},"vat_amount":{"description":"Amount of the applicable VAT (out of the total transaction amount).","example":6,"format":"float","type":"number"}},"type":"object"},"TransactionMixinHistory":{"properties":{"payout_plan":{"description":"Payout plan of the registered user at the time when the transaction was made.","enum":["SINGLE_PAYMENT","TRUE_INSTALLMENT","ACCELERATED_INSTALLMENT"],"type":"string"},"payouts_received":{"description":"Number of payouts that are made to the registered user specified in the `user` property.","type":"integer"},"payouts_total":{"description":"Total number of payouts to the registered user specified in the `user` property.","type":"integer"},"product_summary":{"description":"Short description of the payment. The value is taken from the `description` property of the related checkout resource.","type":"string"}},"type":"object"},"VatRates":{"description":"Merchant VAT rates","properties":{"country":{"description":"Country ISO code","type":"string"},"description":{"description":"Description","type":"string"},"id":{"description":"Internal ID","type":"number"},"ordering":{"description":"Ordering","type":"number"},"rate":{"description":"Rate","type":"number"}},"type":"object"}},"securitySchemes":{"accessToken":{"description":"At SumUp authentication uses your API credentials and Basic HTTP auth. The API credentials consist of a `client_id` and `client_secret` key-value pair.\n\nIt is possible to create multiple API credentials for each of the applications you connect with your SumUp Profile.\n\nUse the API credentials as an authorization header for requests that require such.\n\nAuthorization\n---------\n\nSumUp uses the [OAuth 2.0 authorization framework](https://tools.ietf.org/html/rfc6749) and supports [two authorization flows](https://developer.sumup.com/docs/authorization/#authorization-flows) for [obtaining an access token](https://developer.sumup.com/docs/register-app/#3-create-oauth-client-credentials).\n\nThe flow you choose will grant your access token-specific permissions. All API calls should include the obtained access token in the `Authorization: Bearer \u003c\u003cvalid_access_token\u003e\u003e` format.\n\nTo complete successful requests, ensure you have requested the [necessary scopes](https://developer.sumup.com/docs/authorization/#authorization-scopes) for your authorization flow of choice.\n","flows":{"authorizationCode":{"authorizationUrl":"https://api.sumup.com/authorize","refreshUrl":"https://api.sumup.com/token","scopes":{"payment_instruments":"Manage customers and their payment instruments.","payments":"Make payments by creating and processing checkouts.","transactions.history":"View transactions and transaction history.","user.app-settings":"View and manage the SumUp mobile application settings.","user.payout-settings":"View and manage your payout settings.","user.profile":"View and manage your user profile.","user.profile_readonly":"View user profile details.","user.subaccounts":"View and manage the user profile details of your employees."},"tokenUrl":"https://api.sumup.com/token"},"clientCredentials":{"scopes":{"payment_instruments":"Manage customers and their payment instruments.","payments":"Make payments by creating and processing checkouts.","transactions.history":"View transactions and transaction history.","user.app-settings":"View and manage the SumUp mobile application settings.","user.payout-settings":"View and manage your payout settings.","user.profile":"View and manage your user profile.","user.profile_readonly":"View user profile details.","user.subaccounts":"View and manage the user profile details of your employee."},"tokenUrl":"https://api.sumup.com/token"}},"type":"oauth2"}}},"info":{"description":"SumUp’s REST API operates with `application/json` HTTP requests and response. The request bodies are sent through resource-oriented URLs and use the standard HTTP response codes.\nFor testing our APIs make sure you have a SumUp Profile (you can create one [here](https://me.sumup.com)). To activate your SumUp Profile [follow these steps](https://help.sumup.com/en-GB/articles/7gSOGSm2wEwIHyAvjitrLF).\n\nOnce you have an active SumUp Profile, go to [developer.sumup.com](https://developer.sumup.com/) and click on “Create” On the top right side, click on “Profile” followed by “Test profiles” Select your business country Click “Create” Copy and store safely the user name (format: 32 characters@developers.sumup.com) and randomly generated unique password.\n\nNote: You will not be able to access your password afterwards make sure to store it safely before dismissing the message\n\nNote: SumUp merchants are able to create up to 20 test profiles\n\nWhen you receive your test profile you can create your [client credentials](https://developer.sumup.com/docs/register-app/#3-create-oauth-client-credentials) and process different requests with real payment instruments, without charging them.\nLegal note: We reserve the right to change, modify, or remove the contents of this Website and SumUp APIs at any time without notice.\n","title":"SumUp REST API","version":"1.0.0"},"openapi":"3.0.1","paths":{"/authorize":{"get":{"description":"Request authorization from users and grant your application access to resources associated with the user's profile.\n","operationId":"Authorize","parameters":[{"description":"The type of the expected response. The value must be `code` to indicate that you expect to receive an authorization code.","example":"code","in":"query","name":"response_type","schema":{"type":"string"}},{"description":"The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app/).","example":"fOcmczrYtYMJ7Li5GjMLLcUeC9dN","in":"query","name":"client_id","schema":{"type":"string"}},{"description":"The URI to which the merchant user is redirected after authorizing your application to access their user's profile data and to which the authorization code is sent. The value must match exactly one of the [registered URIs](https://developer.sumup.com/docs/register-app#3-create-oauth-client-credentials) for your application.","example":"https://sample-app.example.com/callback","in":"query","name":"redirect_uri","schema":{"type":"string"}},{"description":"A space-separated list of scopes for which you request authorization. If you don't specify any scopes in the request, your application will be granted authorization for the default scopes.","example":"payments","in":"query","name":"scope","schema":{"type":"string"}},{"description":"A unique local state that can be used for correlating requests and responses and for preventing [cross-site request forgery](https://tools.ietf.org/html/rfc6749#section-10.12).","example":"2cFCsY36y95lFHk4","in":"query","name":"state","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"NoBody":{"value":{}}},"schema":{"type":"object"}}},"description":"No Content"}},"summary":"Request authorization from users","tags":["Authorization"]}},"/token":{"post":{"description":"Generate a token or a refresh token\n","operationId":"CreateToken","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthToken"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"access_token":{"description":"Successfully created access token","value":{"access_token":"565e2d19cef68203170ddadb952141326d14e03f4ccbd46daa079c26c910a864","expires_in":3600,"refresh_token":"d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af","token_type":"Bearer"}},"refresh_token":{"description":"Successfully created access token with the refresh token","value":{"access_token":"ec410d10ad7f06d3c2598473c9cd61189abcc016900a9938068542bcf9754073","expires_in":3600,"refresh_token":"d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af","scope":"payments user.app-settings transactions.history user.profile_readonly","token_type":"Bearer"}}},"schema":{"properties":{"access_token":{"description":"The access token that you need to use in your requests to the SumUp API.","example":"ec410d10ad7f06d3c2598473c9cd61189abcc016900a9938068542bcf9754073","type":"string"},"expires_in":{"description":"The validity of the access token in seconds.","example":3600,"type":"integer"},"refresh_token":{"description":"The refresh token provided in the request call","example":"d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af","type":"string"},"scope":{"description":"List of authorization scopes granted to your access token.","example":"payments user.app-settings transactions.history user.profile_readonly","type":"string"},"token_type":{"description":"The type of the token. The value is always `Bearer`.","example":"Bearer","type":"string"}},"type":"object"}}},"description":"OK"},"400":{"content":{"application/json":{"examples":{"Invalid_Parameter":{"description":"A parameter is invalid or expired.","value":{"error":"invalid_grant","error_description":"code parameter invalid or expired"}},"Missing_Parameter":{"description":"A parameter is missing in the request.","value":{"error":"invalid_request","error_description":"code parameter is missing"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad Request"}},"summary":"Generate a token","tags":["Authorization"]}},"/v0.1/checkouts":{"get":{"description":"Lists created checkout resources according to the applied `checkout_reference`.","operationId":"ListCheckouts","parameters":[{"description":"Filters the list of checkout resources by the unique ID of the checkout.","in":"query","name":"checkout_reference","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CheckoutSuccess"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"List checkouts","tags":["Checkouts"],"x-codegen":{"method_name":"list"},"x-scopes":["payments"]},"post":{"description":"Creates a new payment checkout resource. The unique `checkout_reference` created by this request, is used for further manipulation of the checkout.\n\nFor 3DS checkouts, add the `redirect_url` parameter to your request body schema.\n\nFollow by processing a checkout to charge the provided payment instrument.\n","operationId":"CreateCheckout","requestBody":{"content":{"application/json":{"examples":{"Checkout":{"description":"Standard request body for creating a checkout","value":{"amount":10.1,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","date":"2020-02-29T10:56:56+00:00","description":"Purchase","id":"2b79757a-de87-4a2e-90e4-b17c947c730d","merchant_code":"MDUDGLR9","merchant_name":"John Doe LTD","pay_to_email":"user@example.com","redirect_url":"https://sumup.com","status":"PAID"}},"Checkout3DS":{"description":"Create a 3DS checkout","value":{"amount":10.1,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","customer_id":"831ff8d4cd5958ab5670","description":"Purchase","merchant_code":"MH4H92C7","pay_to_email":"user@example.com","redirect_url":"https://mysite.com/completed_purchase","return_url":"http://example.com/"}},"CheckoutAPM":{"description":"Create an Alternative Payment Method checkout","value":{"amount":10.1,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","merchant_code":"MH4H92C7","redirect_url":"https://mysite.com/completed_purchase"}}},"schema":{"$ref":"#/components/schemas/CheckoutCreateRequest"}}}},"responses":{"201":{"content":{"application/json":{"examples":{"Checkout":{"description":"Standard response body for a successfully created checkout","value":{"amount":10.1,"checkout_reference":"8ea25ec3-3293-40e9-a165-6d7f3b3073c5","currency":"EUR","customer_id":"831ff8d4cd5958ab5670","date":"2020-02-29T10:56:56+00:00","description":"My Checkout","id":"88fcf8de-304d-4820-8f1c-ec880290eb92","mandate":{"merchant_code":"MDASYTPD","status":"active","type":"recurrent"},"merchant_code":"MCNPLE22","merchant_country":"DE","pay_to_email":"user@example.com","return_url":"http://example.com","status":"PENDING","transactions":[{"amount":10.1,"auth_code":"012345","currency":"EUR","entry_mode":"CUSTOMER_ENTRY","id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","installments_count":1,"internal_id":0,"merchant_code":"MH4H92C7","payment_type":"ECOM","status":"SUCCESSFUL","timestamp":"2020-02-29T10:56:56.876Z","tip_amount":3,"transaction_code":"TEENSK4W2K","vat_amount":6}],"valid_until":"2020-02-29T10:56:56+00:00"}},"Checkout3DS":{"description":"Response body for a successfully created 3DS checkout","value":{"amount":10.1,"checkout_reference":"8ea25ec3-3293-40e9-a165-6d7f3b3073c5","currency":"EUR","customer_id":"831ff8d4cd5958ab5670","date":"2020-02-29T10:56:56+00:00","description":"My Checkout","id":"88fcf8de-304d-4820-8f1c-ec880290eb92","pay_to_email":"user@example.com","redirect_url":"https://mysite.com/completed_purchase","return_url":"http://example.com","status":"PENDING","transactions":[{"amount":10.1,"auth_code":"012345","currency":"EUR","entry_mode":"CUSTOMER_ENTRY","id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","installments_count":1,"internal_id":0,"merchant_code":"MH4H92C7","payment_type":"ECOM","status":"SUCCESSFUL","timestamp":"2020-02-29T10:56:56.876Z","tip_amount":3,"transaction_code":"TEENSK4W2K","vat_amount":6}],"valid_until":"2020-02-29T10:56:56+00:00"}},"CheckoutAPM":{"description":"Response body for APMs, including Blik, iDeal, ...","value":{"amount":10.1,"checkout_reference":"8ea25ec3-3293-40e9-a165-6d7f3b3073c5","currency":"EUR","date":"2021-06-29T11:08:36.000+00:00","description":"My Checkout","id":"88fcf8de-304d-4820-8f1c-ec880290eb92","merchant_code":"MCNPLE22","merchant_country":"DE","merchant_name":"My company","pay_to_email":"user@example.com","purpose":"CHECKOUT","redirect_url":"https://sumup.com","return_url":"http://example.com","status":"PENDING","transactions":[{"amount":10.1,"auth_code":"012345","currency":"EUR","entry_mode":"CUSTOMER_ENTRY","id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","installments_count":1,"internal_id":0,"merchant_code":"MH4H92C7","payment_type":"ECOM","status":"SUCCESSFUL","timestamp":"2020-02-29T10:56:56.876Z","tip_amount":3,"transaction_code":"TEENSK4W2K","vat_amount":6}]}}},"schema":{"$ref":"#/components/schemas/Checkout"}}},"description":"Created"},"400":{"content":{"application/json":{"examples":{"Missing_Parameter":{"description":"A required parameter is missing.","value":{"error_code":"MISSING","message":"Validation error","param":"pay_to_email"}}},"schema":{"$ref":"#/components/schemas/ErrorExtended"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have the required permission for making this request.","value":{"error_code":"FORBIDDEN","error_message":"checkout_payments_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"409":{"content":{"application/json":{"examples":{"Existing_Checkout":{"description":"A resource with the specified parameters already exists on the server.","value":{"error_code":"DUPLICATED_CHECKOUT","message":"Checkout with this checkout reference and pay to email already exists"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflict"}},"summary":"Create a checkout","tags":["Checkouts"],"x-codegen":{"method_name":"create"},"x-scopes":["payments"]}},"/v0.1/checkouts/{id}":{"delete":{"description":"Deactivates an identified checkout resource. If the checkout has already been processed it can not be deactivated.","operationId":"DeactivateCheckout","responses":{"200":{"content":{"application/json":{"examples":{"DeletedCheckout":{"description":"Response body for a successfully deactivated checkout","value":{"amount":2,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","date":"2020-02-29T10:56:56+00:00","description":"Deletion example","id":"817340ce-f1d9-4609-b90a-6152f8ee267j","merchant_code":"MH4H92C7","merchant_name":"Sample Merchant","pay_to_email":"user@example.com","purpose":"CHECKOUT","status":"EXPIRED","transactions":[],"valid_until":"2020-02-29T10:56:56+00:00"}}},"schema":{"description":"Details of the deleted checkout.","properties":{"amount":{"description":"Amount of the payment.","format":"float","type":"number"},"checkout_reference":{"description":"Unique ID of the payment checkout specified by the client application when creating the checkout resource.","maxLength":90,"type":"string"},"currency":{"$ref":"#/components/schemas/Currency"},"date":{"description":"Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.","example":"2020-02-29T10:56:56+00:00","format":"date-time","readOnly":true,"type":"string"},"description":{"description":"Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.","type":"string"},"id":{"description":"Unique ID of the checkout resource.","readOnly":true,"type":"string"},"merchant_code":{"description":"Unique identifying code of the merchant profile.","type":"string"},"merchant_country":{"description":"The merchant's country","type":"string"},"merchant_name":{"description":"Merchant name","type":"string"},"pay_to_email":{"description":"Email address of the registered user (merchant) to whom the payment is made. It is highly recommended to use `merchant_code` instead of `pay_to_email`.","format":"email","type":"string"},"purpose":{"description":"Purpose of the checkout creation initially","enum":["SETUP_RECURRING_PAYMENT","CHECKOUT"],"type":"string"},"status":{"description":"Current status of the checkout.","enum":["EXPIRED"],"readOnly":true,"type":"string"},"transactions":{"description":"List of transactions related to the payment.","items":{"allOf":[{"$ref":"#/components/schemas/TransactionMixinBase"},{"$ref":"#/components/schemas/TransactionMixinCheckout"}]},"readOnly":true,"type":"array","uniqueItems":true},"valid_until":{"description":"Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.","example":"2020-02-29T10:56:56+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"type":"object"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"},"409":{"content":{"application/json":{"examples":{"Checkout_Processed":{"description":"The identified checkout resource is already processed.","value":{"error_code":"CHECKOUT_PROCESSED","message":"Checkout is already processed"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflict"}},"summary":"Deactivate a checkout","tags":["Checkouts"],"x-codegen":{"method_name":"deactivate"},"x-scopes":["payments"]},"get":{"description":"Retrieves an identified checkout resource. Use this request after processing a checkout to confirm its status and inform the end user respectively.","operationId":"GetCheckout","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutSuccess"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Retrieve a checkout","tags":["Checkouts"],"x-codegen":{"method_name":"get"},"x-scopes":["payments"]},"parameters":[{"description":"Unique ID of the checkout resource.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"put":{"description":"Processing a checkout will attempt to charge the provided payment instrument for the amount of the specified checkout resource initiated in the `Create a checkout` endpoint.\n\nFollow this request with `Retrieve a checkout` to confirm its status.\n","operationId":"ProcessCheckout","requestBody":{"content":{"application/json":{"examples":{"ProcessBancontact":{"description":"Process a checkout with Bancontact","value":{"payment_type":"bancontact","personal_details":{"address":{"country":"BE"},"email":"user@example.com","first_name":"John","last_name":"Doe"}}},"ProcessBoleto":{"description":"Process a checkout with Boleto","value":{"payment_type":"boleto","personal_details":{"address":{"city":"São Paulo","country":"BR","line1":"Rua Gilberto Sabino, 215","postal_code":"05425-020","state":"SP"},"email":"user@example.com","first_name":"John","last_name":"Doe","tax_id":"423.378.593-47"}}},"ProcessCard":{"description":"Process a checkout with a card","value":{"card":{"cvv":"123","expiry_month":"01","expiry_year":"2023","last_4_digits":"3456","name":"John Doe","number":"1234567890123456","type":"VISA","zip_code":"12345"},"installments":1,"mandate":{"type":"recurrent","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36","user_ip":"172.217.169.174"},"payment_type":"card"}},"ProcessToken":{"description":"Process a checkout with a token","value":{"customer_id":"MEDKHDTI","installments":1,"payment_type":"card","token":"ba85dfee-c3cf-48a6-84f5-d7d761fbba50"}},"ProcessiDeal":{"description":"Process a checkout with iDeal","value":{"payment_type":"ideal","personal_details":{"address":{"country":"NL"},"email":"user@example.com","first_name":"John","last_name":"Doe"}}}},"schema":{"$ref":"#/components/schemas/CheckoutProcessMixin"}}},"description":"Details of the payment instrument for processing the checkout."},"responses":{"200":{"content":{"application/json":{"examples":{"CheckoutSuccessBancontact":{"description":"Successfully processed checkout with Bancontact","value":{"next_step":{"full":"https://r3.girogate.de/ti/simbcmc?tx=624788471\u0026rs=5MioXoKt2Gwj9dLgqAX1bMRBuT5xTSdB\u0026cs=697edacdd9175f3f99542500fa0ff08280b66aaff3c2641a2e212e4b039473cc","mechanism":["browser"],"method":"GET","payload":{"cs":"697edacdd9175f3f99542500fa0ff08280b66aaff3c2641a2e212e4b039473cc","rs":"5MioXoKt2Gwj9dLgqAX1bMRBuT5xTSdB","tx":"624788471"},"url":"https://r3.girogate.de/ti/simbcmc"}}},"CheckoutSuccessBoleto":{"description":"Successfully processed checkout with Boleto","value":{"amount":10.1,"boleto":{"barcode":"34191090081790614310603072340007886840000000200","url":"https://checkouts.sample.com/v0.1/checkouts/2e7a36cc-7897-446b-a966-952ab5f049ea/boleto"},"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"BRL","date":"2021-07-06T12:34:02.000+00:00","description":"Boleto checkout","id":"4e425463-3e1b-431d-83fa-1e51c2925e99","merchant_code":"MH4H92C7","merchant_name":"Sample shop","pay_to_email":"user@example.com","purpose":"CHECKOUT","redirect_url":"https://website.com","status":"PENDING","transactions":[{"amount":10.1,"currency":"BRL","entry_mode":"BOLETO","id":"debd2986-9852-4e86-8a8e-7ea9c87dd679","installments_count":1,"internal_id":1763892018,"merchant_code":"MH4H92C9","payment_type":"BOLETO","status":"PENDING","timestamp":"2021-07-06T12:34:16.460+00:00","tip_amount":3,"transaction_code":"TEN3E696NP","vat_amount":6}]}},"CheckoutSuccessCard":{"description":"Successfully processed checkout with a card","value":{"amount":10.1,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","customer_id":"831ff8d4cd5958ab5670","date":"2020-02-29T10:56:56+00:00","description":"Purchase","id":"4e425463-3e1b-431d-83fa-1e51c2925e99","mandate":{"merchant_code":"MDASYTPD","status":"active","type":"recurrent"},"merchant_code":"MH4H92C7","pay_to_email":"user@example.com","return_url":"http://example.com","status":"PENDING","transaction_code":"TEENSK4W2K","transaction_id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","transactions":[{"amount":10.1,"auth_code":"053201","currency":"EUR","entry_mode":"CUSTOMER_ENTRY","id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","installments_count":1,"internal_id":1763892018,"merchant_code":"MH4H92C7","payment_type":"ECOM","status":"SUCCESSFUL","timestamp":"2020-02-29T10:56:56.876Z","tip_amount":3,"transaction_code":"TEENSK4W2K","vat_amount":6}],"valid_until":"2020-02-29T10:56:56+00:00"}},"CheckoutSuccessToken":{"description":"Successfully processed checkout with a token","value":{"amount":10.1,"checkout_reference":"f00a8f74-b05d-4605-bd73-2a901bae5802","currency":"EUR","customer_id":"831ff8d4cd5958ab5670","date":"2020-02-29T10:56:56+00:00","description":"Purchase with token","id":"4e425463-3e1b-431d-83fa-1e51c2925e99","merchant_code":"MH4H92C7","merchant_name":"Sample Merchant","pay_to_email":"user@example.com","payment_instrument":{"token":"e76d7e5c-9375-4fac-a7e7-b19dc5302fbc"},"redirect_url":"https://mysite.com/completed_purchase","status":"PENDING","transaction_code":"TEENSK4W2K","transaction_id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","transactions":[{"amount":10.1,"auth_code":"053201","currency":"EUR","entry_mode":"CUSTOMER_ENTRY","id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","installments_count":1,"internal_id":1763892018,"merchant_code":"MH4H92C7","payment_type":"ECOM","status":"SUCCESSFUL","timestamp":"2020-02-29T10:56:56.876Z","tip_amount":3,"transaction_code":"TEENSK4W2K","vat_amount":6}]}},"CheckoutSuccessiDeal":{"description":"Successfully processed checkout with iDeal","value":{"next_step":{"full":"https://r3.girogate.de/ti/simideal?tx=961473700\u0026rs=ILnaUeQTKJ184fVrjGILrLjePX9E4rmz\u0026cs=c8bc0ea231f8372431ca22d6f8319f8de0263d0b1705759ed27155f245f193c5","mechanism":["browser"],"method":"GET","payload":{"cs":"c8bc0ea231f8372431ca22d6f8319f8de0263d0b1705759ed27155f245f193c5","rs":"ILnaUeQTKJ184fVrjGILrLjePX9E4rmz","tx":"961473700"},"url":"https://r3.girogate.de/ti/simideal"}}}},"schema":{"$ref":"#/components/schemas/CheckoutSuccess"}}},"description":"OK"},"400":{"content":{"application/json":{"examples":{"Invalid_Parameter":{"description":"A required parameter has an invalid value.","value":{"error_code":"INVALID","message":"Validation error","param":"card.expiry_year"}},"Multiple_Invalid_Parameters":{"description":"Multiple required parameters have invalid values.","value":[{"error_code":"INVALID","message":"Validation error","param":"card.name"},{"error_code":"INVALID","message":"Validation error","param":"card.number"},{"error_code":"INVALID","message":"Validation error","param":"card.expiry_year"}]}},"schema":{"oneOf":[{"$ref":"#/components/schemas/ErrorExtended"},{"description":"List of error messages.","items":{"$ref":"#/components/schemas/ErrorExtended"},"type":"array"}]}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"},"409":{"content":{"application/json":{"examples":{"Checkout_Processed":{"description":"The identified checkout resource is already processed.","value":{"error_code":"CHECKOUT_PROCESSED","message":"Checkout is already processed"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflict"}},"summary":"Process a checkout","tags":["Checkouts"],"x-codegen":{"method_name":"process"}}},"/v0.1/customers":{"post":{"description":"Creates a new saved customer resource which you can later manipulate and save payment instruments to.","operationId":"CreateCustomer","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"Details of the customer."},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"Created"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"409":{"content":{"application/json":{"examples":{"Existing_Customer":{"description":"A resource with the specified identifier already exists on the server.","value":{"error_code":"CUSTOMER_ALREADY_EXISTS","message":"Customer already exists"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflict"}},"summary":"Create a customer","tags":["Customers"],"x-codegen":{"method_name":"create"},"x-scopes":["payment_instruments"]}},"/v0.1/customers/{customer_id}":{"get":{"description":"Retrieves an identified saved customer resource through the unique `customer_id` parameter, generated upon customer creation.","operationId":"GetCustomer","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"Created"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Retrieve a customer","tags":["Customers"],"x-codegen":{"method_name":"get"},"x-scopes":["payment_instruments"]},"parameters":[{"description":"Unique ID of the saved customer resource.","in":"path","name":"customer_id","required":true,"schema":{"type":"string"}}],"put":{"description":"Updates an identified saved customer resource's personal details.\n\nThe request only overwrites the parameters included in the request, all other parameters will remain with their initially assigned values.\n","operationId":"UpdateCustomer","requestBody":{"content":{"application/json":{"schema":{"properties":{"personal_details":{"$ref":"#/components/schemas/PersonalDetails"}},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"Created"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Update a customer","tags":["Customers"],"x-codegen":{"method_name":"update"},"x-scopes":["payment_instruments"]}},"/v0.1/customers/{customer_id}/payment-instruments":{"get":{"description":"Lists all payment instrument resources that are saved for an identified customer.","operationId":"ListPaymentInstruments","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PaymentInstrumentResponse"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"List payment instruments","tags":["Customers"],"x-codegen":{"method_name":"list_payment_instruments"},"x-scopes":["payment_instruments"]},"parameters":[{"description":"Unique ID of the saved customer resource.","in":"path","name":"customer_id","required":true,"schema":{"type":"string"}}]},"/v0.1/customers/{customer_id}/payment-instruments/{token}":{"delete":{"description":"Deactivates an identified card payment instrument resource for a customer.","operationId":"DeactivatePaymentInstrument","responses":{"204":{"content":{"application/json":{"examples":{"NoBody":{"value":{}}},"schema":{"type":"object"}}},"description":"No Content"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Deactivate a payment instrument","tags":["Customers"],"x-codegen":{"method_name":"deactivate_payment_instrument"},"x-scopes":["payment_instruments"]},"parameters":[{"description":"Unique ID of the saved customer resource.","in":"path","name":"customer_id","required":true,"schema":{"type":"string"}},{"description":"Unique token identifying the card saved as a payment instrument resource.","in":"path","name":"token","required":true,"schema":{"type":"string"}}]},"/v0.1/me":{"get":{"description":"Returns user profile information.","operationId":"GetAccount","parameters":[{"description":"A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.","in":"query","name":"include[]","schema":{"items":{"enum":["settings","doing_business_as","bank_accounts","app_settings","country_details"],"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantAccount"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"Retrieve a profile","tags":["Merchant"],"x-codegen":{"method_name":"get"},"x-scopes":["user.profile","user.profile_readonly"]}},"/v0.1/me/accounts":{"get":{"deprecated":true,"description":"Returns list of operators for currently authorized user's merchant.","operationId":"ListSubAccounts","parameters":[{"description":"Search query used to filter users that match given query term.\n\nCurrent implementation allow querying only over the email address.\nAll operators whos email address contains the query string are returned.\n","in":"query","name":"query","schema":{"type":"string"}},{"description":"If true the list of operators will include also the primary user.","in":"query","name":"include_primary","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Operator"},"type":"array"}}},"description":"List of operators."}},"summary":"List operators.","tags":["Subaccounts"],"x-permissions":["members_list"],"x-scopes":[]},"post":{"deprecated":true,"description":"Creates new operator for currently authorized users' merchant.","operationId":"CreateSubAccount","requestBody":{"content":{"application/json":{"schema":{"properties":{"nickname":{"example":"Operator 1","type":"string"},"password":{"example":"correct horse batter staple","minLength":8,"type":"string"},"permissions":{"properties":{"create_moto_payments":{"type":"boolean"},"create_referral":{"type":"boolean"},"full_transaction_history_view":{"type":"boolean"},"refund_transactions":{"type":"boolean"}},"type":"object"},"username":{"example":"operator1@mydomain.com","format":"email","type":"string"}},"required":["username","password"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Newly created operator."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}},"description":"error response for compat API calls"}},"summary":"Create operator.","tags":["Subaccounts"],"x-permissions":["members_update"],"x-scopes":[]}},"/v0.1/me/accounts/{operator_id}":{"delete":{"deprecated":true,"operationId":"DeactivateSubAccount","parameters":[{"in":"path","name":"operator_id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Operator successfully disabled."}},"summary":"Disable operator.","tags":["Subaccounts"],"x-permissions":["members_delete"],"x-scopes":[]},"get":{"deprecated":true,"description":"Returns specific operator.","operationId":"CompatGetOperator","parameters":[{"in":"path","name":"operator_id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Operator."}},"summary":"Get operator","tags":["Subaccounts"],"x-permissions":["members_view"],"x-scopes":[]},"put":{"deprecated":true,"description":"Updates operator. If the operator was disabled and their password is updated they will be unblocked.","operationId":"UpdateSubAccount","parameters":[{"in":"path","name":"operator_id","required":true,"schema":{"format":"int32","type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"disabled":{"type":"boolean"},"nickname":{"example":"Operator 1","type":"string"},"password":{"example":"correct horse batter staple","minLength":8,"type":"string"},"permissions":{"properties":{"create_moto_payments":{"type":"boolean"},"create_referral":{"type":"boolean"},"full_transaction_history_view":{"type":"boolean"},"refund_transactions":{"type":"boolean"}},"type":"object"},"username":{"format":"email","maxLength":256,"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Updated operator."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}},"description":"Invalid Operators' email or password was already used."}},"summary":"Update operator.","tags":["Subaccounts"],"x-permissions":["members_update"],"x-scopes":[]}},"/v0.1/me/accounts/{operator_id}/disable":{"post":{"deprecated":true,"operationId":"CompatDisableOperator","parameters":[{"in":"path","name":"operator_id","required":true,"schema":{"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Operator successfully disabled."}},"summary":"Disable operator.","tags":["Subaccounts"],"x-permissions":["members_write"],"x-scopes":[]}},"/v0.1/me/accounts/{operator_id}/reset":{"put":{"deprecated":true,"description":"Changes operators password, if the operator was disabled they will be unblocked.","operationId":"CompatChangeOperatorsPassword","parameters":[{"in":"path","name":"operator_id","required":true,"schema":{"format":"int32","type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"password":{"example":"correct horse batter staple","minLength":8,"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}},"description":"Operators' password successfully changed."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}},"description":"Operators' password was already used."}},"summary":"Change operators password.","tags":["Subaccounts"],"x-permissions":["members_write"],"x-scopes":[]}},"/v0.1/me/financials/payouts":{"get":{"description":"Lists ordered payouts for the merchant profile.","operationId":"ListPayouts","parameters":[{"description":"Start date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"start_date","required":true,"schema":{"format":"date","type":"string"}},{"description":"End date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"end_date","required":true,"schema":{"format":"date","type":"string"}},{"in":"query","name":"format","schema":{"enum":["json","csv"],"type":"string"}},{"in":"query","name":"limit","schema":{"type":"integer"}},{"in":"query","name":"order","schema":{"enum":["desc","asc"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialPayouts"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"List payouts","tags":["Payouts"],"x-codegen":{"method_name":"list"},"x-scopes":["user.profile","user.profile_readonly"]}},"/v0.1/me/merchant-profile":{"get":{"description":"Retrieves merchant profile data.","operationId":"GetMerchantProfile","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantProfile"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"}},"summary":"Retrieve a merchant profile","tags":["Merchant"],"x-codegen":{"method_name":"get_merchant_profile"},"x-scopes":["user.profile","user.profile_readonly"]}},"/v0.1/me/merchant-profile/bank-accounts":{"get":{"deprecated":true,"description":"Retrieves bank accounts of the merchant.","operationId":"ListBankAccounts","parameters":[{"description":"If true only the primary bank account (the one used for payouts) will be returned.","in":"query","name":"primary","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BankAccount"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"}},"summary":"List bank accounts (deprecated)","tags":["Merchant"],"x-codegen":{"method_name":"list_bank_accounts_deprecated"},"x-scopes":["user.payout-settings","user.profile","user.profile_readonly"]}},"/v0.1/me/merchant-profile/doing-business-as":{"get":{"description":"Retrieves Doing Business As profile.","operationId":"GetDoingBusinessAs","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoingBusinessAs"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"Retrieve DBA","tags":["Merchant"],"x-codegen":{"method_name":"get_doing_business_as"},"x-scopes":["user.profile","user.profile_readonly"]}},"/v0.1/me/merchant-profile/settings":{"get":{"description":"Retrieves merchant settings.","operationId":"GetSettings","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantSettings"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"}},"summary":"Get settings","tags":["Merchant"],"x-codegen":{"method_name":"get_settings"},"x-scopes":["user.payout-settings"]}},"/v0.1/me/personal-profile":{"get":{"description":"Retrieves personal profile data.","operationId":"GetPersonalProfile","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalProfile"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"Retrieve a personal profile","tags":["Merchant"],"x-codegen":{"method_name":"get_personal_profile"},"x-scopes":["user.profile","user.profile_readonly"]}},"/v0.1/me/refund/{txn_id}":{"parameters":[{"description":"Unique ID of the transaction.","in":"path","name":"txn_id","required":true,"schema":{"type":"string"}}],"post":{"description":"Refunds an identified transaction either in full or partially.","operationId":"RefundTransaction","requestBody":{"content":{"application/json":{"schema":{"description":"Optional amount for partial refunds of transactions.","properties":{"amount":{"description":"Amount to be refunded. Eligible amount can't exceed the amount of the transaction and varies based on country and currency. If you do not specify a value, the system performs a full refund of the transaction.","format":"float","type":"number"}},"type":"object"}}}},"responses":{"204":{"content":{"application/json":{"examples":{"NoBody":{"value":{}}},"schema":{"type":"object"}}},"description":"No Content"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"},"409":{"content":{"application/json":{"examples":{"Transaction_Not_Refundable":{"description":"The state of the identified transaction resource does not permit the requested operation.","value":{"error_code":"CONFLICT","message":"The transaction is not refundable in its current state"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Conflict"}},"summary":"Refund a transaction","tags":["Transactions"],"x-codegen":{"method_name":"refund"},"x-scopes":["payments"]}},"/v0.1/me/transactions":{"get":{"deprecated":true,"description":"Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required:\n * `id`\n * `internal_id`\n * `transaction_code`\n * `foreign_transaction_id`\n * `client_transaction_id`\n","operationId":"GetTransaction","parameters":[{"description":"Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).","in":"query","name":"id","schema":{"type":"string"}},{"description":"Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).","in":"query","name":"internal_id","schema":{"type":"string"}},{"description":"Retrieves the transaction resource with the specified transaction code.","in":"query","name":"transaction_code","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionFull"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Retrieve a transaction (deprecated)","tags":["Transactions"],"x-codegen":{"method_name":"get_deprecated"},"x-scopes":["transactions.history"]}},"/v0.1/me/transactions/history":{"get":{"deprecated":true,"description":"Lists detailed history of all transactions associated with the merchant profile.","operationId":"ListTransactions","parameters":[{"description":"Retrieves the transaction resource with the specified transaction code.","in":"query","name":"transaction_code","schema":{"type":"string"}},{"description":"Specifies the order in which the returned results are displayed.","in":"query","name":"order","schema":{"default":"ascending","enum":["ascending","descending"],"type":"string"}},{"description":"Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Filters the returned results by user email.","in":"query","name":"users","schema":{"items":{"format":"email","type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of final statuses of the transactions.","in":"query","name":"statuses","schema":{"items":{"enum":["SUCCESSFUL","CANCELLED","FAILED","REFUNDED","CHARGE_BACK"],"type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of payment types used for the transactions.","in":"query","name":"payment_types","schema":{"items":{"enum":["CASH","POS","ECOM","BALANCE","MOTO","BOLETO","UNKNOWN"],"type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of transaction types.","in":"query","name":"types","schema":{"items":{"enum":["PAYMENT","REFUND","CHARGE_BACK"],"type":"string"},"type":"array"}},{"description":"Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"changes_since","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"newest_time","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).","in":"query","name":"newest_ref","schema":{"type":"string"}},{"description":"Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"oldest_time","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).","in":"query","name":"oldest_ref","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TransactionHistory"},"type":"array"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"}},"type":"object"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"List transactions (deprecated)","tags":["Transactions"],"x-codegen":{"method_name":"list_deprecated"},"x-scopes":["transactions.history"]}},"/v0.1/merchants/{merchant_code}/api-keys":{"get":{"description":"Returns paginated list of API keys.\n","operationId":"ListAPIKeys","parameters":[{"description":"Offset of the first key to return.","in":"query","name":"offset","schema":{"default":0,"example":0,"minimum":0,"type":"integer"}},{"description":"Maximum number of keys to return.","in":"query","name":"limit","schema":{"default":10,"example":10,"maximum":25,"minimum":1,"type":"integer"}},{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeysList"}}},"description":"List of API keys."}},"summary":"List API keys","tags":["API Keys"],"x-permissions":["api_keys_list"],"x-scopes":["api_keys"]},"post":{"description":"Creates a new API key for the user.\n","operationId":"CreateAPIKey","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"example":"New Key Name","maxLength":255,"type":"string"},"scopes":{"$ref":"#/components/schemas/OAuth2Scopes"}},"required":["name","scopes"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"Created API key."}},"summary":"Create an API key","tags":["API Keys"],"x-permissions":["api_keys_create"],"x-scopes":["api_keys:write"]}},"/v0.1/merchants/{merchant_code}/api-keys/{key_id}":{"delete":{"description":"Revokes an API key.\n","operationId":"RevokeAPIKey","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"key_id","required":true,"schema":{"example":"sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9","type":"string"}}],"responses":{"204":{"description":"Successful revocation."}},"summary":"Revoke an API key","tags":["API Keys"],"x-permissions":["api_keys_delete"],"x-scopes":["api_keys:write"]},"get":{"description":"Gets an API key.\n","operationId":"GetAPIKey","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"key_id","required":true,"schema":{"example":"sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"API key."}},"summary":"Retrieve an API Key","tags":["API Keys"],"x-permissions":["api_keys_view"],"x-scopes":["api_keys"]},"put":{"description":"Updates an API key.\n","operationId":"UpdateAPIKey","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"key_id","required":true,"schema":{"example":"sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"description":"New name for the API key.","example":"My API Key","maxLength":255,"type":"string"},"scopes":{"$ref":"#/components/schemas/OAuth2Scopes"}},"required":["name","scopes"],"type":"object"}}},"required":true},"responses":{"204":{"description":"Successful update."}},"summary":"Update an API key","tags":["API Keys"],"x-permissions":["api_keys_update"],"x-scopes":["api_keys:write"]}},"/v0.1/merchants/{merchant_code}/members":{"get":{"description":"Lists merchant members with their roles and permissions.\n","operationId":"ListMerchantMembers","parameters":[{"description":"Offset of the first member to return.","in":"query","name":"offset","schema":{"default":0,"example":0,"minimum":0,"type":"integer"}},{"description":"Maximum number of member to return.","in":"query","name":"limit","schema":{"default":10,"example":10,"maximum":25,"minimum":1,"type":"integer"}},{"description":"Indicates to skip count query.","in":"query","name":"scroll","schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Filter the returned users by email address prefix.","in":"query","name":"email","schema":{"example":"user","type":"string"}},{"description":"Filter the returned members by the membership status.","in":"query","name":"status","schema":{"$ref":"#/components/schemas/MembershipStatus"}},{"description":"Filter the returned users by role.","explode":true,"in":"query","name":"roles","schema":{"example":["role_employee","role_accountant"],"items":{"type":"string"},"type":"array"},"style":"form"},{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Member"},"type":"array"},"total_count":{"example":3,"type":"integer"}},"required":["items"],"type":"object"}}},"description":"List of members."},"404":{"description":"Merchant not found."}},"summary":"List members","tags":["Members"],"x-scopes":[]},"post":{"operationId":"AddMerchantMember","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"attributes":{"$ref":"#/components/schemas/Attributes"},"email":{"description":"Email address of the member to add.","format":"email","type":"string"},"is_managed_user":{"description":"True if the user is managed by the merchant. In this case, we'll created a virtual user with the provided password and nickname.\n","type":"boolean"},"metadata":{"$ref":"#/components/schemas/Metadata"},"nickname":{"description":"Nickname of the member to add. Only used if `is_managed_user` is true. Used for display purposes only.\n","example":"Test User","type":"string"},"password":{"description":"Password of the member to add. Only used if `is_managed_user` is true.","format":"password","minLength":8,"type":"string"},"roles":{"description":"List of roles to assign to the new member.","items":{"type":"string"},"type":"array"}},"required":["email","roles"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}},"description":"Member created."},"400":{"description":"Invalid request."},"404":{"description":"Merchant not found."},"429":{"description":"Too many invitations sent to that user. The limit is 10 requests per 5 minutes and the Retry-After header is set to the number of minutes until the reset of the limit.\n"}},"summary":"Add member to merchant.","tags":["Members"],"x-permissions":["members_create"],"x-scopes":[]}},"/v0.1/merchants/{merchant_code}/members/{member_id}":{"delete":{"description":"Deletes member by ID.","operationId":"DeleteMerchantMember","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"member_id","required":true,"schema":{"example":"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP","type":"string"}}],"responses":{"200":{"description":"Member deleted."},"404":{"description":"Merchant or member not found."}},"summary":"Delete member","tags":["Members"],"x-permissions":["members_delete"],"x-scopes":[]},"get":{"description":"Returns merchant member details.","operationId":"GetMerchantMember","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"member_id","required":true,"schema":{"example":"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}},"description":"Merchant member."},"404":{"description":"Merchant or member not found."}},"summary":"Get merchant member","tags":["Members"],"x-permissions":["members_view"],"x-scopes":[]},"put":{"description":"Update assigned roles of the member.","operationId":"UpdateMerchantMember","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"in":"path","name":"member_id","required":true,"schema":{"example":"mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"attributes":{"$ref":"#/components/schemas/Attributes"},"metadata":{"$ref":"#/components/schemas/Metadata"},"roles":{"items":{"type":"string"},"type":"array"},"user":{"description":"Allows you to update user data of managed users.","properties":{"nickname":{"description":"User's preferred name. Used for display purposes only.\n","example":"Test User","type":"string"},"password":{"description":"Password of the member to add. Only used if `is_managed_user` is true.","format":"password","minLength":8,"type":"string"}},"type":"object"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}},"description":"Member updated."},"400":{"description":"Cannot set password or nickname for an invited user."},"403":{"description":"Cannot change password for managed user. Password was already used before."},"404":{"description":"Merchant or member not found."},"409":{"description":"Cannot update member as some data conflict with existing members."}},"summary":"Update merchant member","tags":["Members"],"x-permissions":["members_update"],"x-scopes":[]}},"/v0.1/merchants/{merchant_code}/payment-methods":{"get":{"description":"Get payment methods available for the given merchant to use with a checkout.","operationId":"GetPaymentMethods","parameters":[{"description":"The SumUp merchant code.","in":"path","name":"merchant_code","required":true,"schema":{"example":"M1234","type":"string"}},{"description":"The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.","in":"query","name":"amount","schema":{"example":9.99,"type":"number"}},{"description":"The currency for which the payment methods should be eligible.","in":"query","name":"currency","schema":{"example":"EUR","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"success":{"description":"Available payment methods","value":{"available_payment_methods":[{"id":"apple_pay"},{"id":"blik"}]}}},"schema":{"properties":{"available_payment_methods":{"items":{"properties":{"id":{"description":"The ID of the payment method.","example":"qr_code_pix","type":"string"}},"required":["id"],"type":"object"},"type":"array"}},"type":"object"}}},"description":"Available payment methods"},"400":{"content":{"application/json":{"examples":{"Invalid_Parameter":{"description":"One or more of the parameters are invalid.","value":{"failed_constraints":[{"message":"Currency must also be specified when filtering by amount","reference":"currency"}],"status":400,"title":"Bad Request"}}},"schema":{"$ref":"#/components/schemas/DetailsError"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"Get available payment methods","tags":["Checkouts"],"x-codegen":{"method_name":"list_available_payment_methods"},"x-scopes":["payments"]}},"/v0.1/merchants/{merchant_code}/readers":{"get":{"description":"Returns list of all readers of the merchant.\n","operationId":"ListReaders","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Reader"},"type":"array"}},"required":["items"],"type":"object"}}},"description":"List of readers\n"}},"summary":"List Readers","tags":["Readers"],"x-permissions":["readers_list"],"x-scopes":["readers.read"]},"post":{"description":"Create a new reader linked to the merchant account.\n","operationId":"CreateReader","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"name":{"$ref":"#/components/schemas/ReaderName"},"pairing_code":{"$ref":"#/components/schemas/ReaderPairingCode"}},"required":["pairing_code"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"examples":{"created":{"$ref":"#/components/examples/CreatedReader"}},"schema":{"$ref":"#/components/schemas/Reader"}}},"description":"The reader got created.\n","links":{"DeleteReaderByID":{"$ref":"#/components/links/DeleteReaderByID"},"UpdateReaderByID":{"$ref":"#/components/links/UpdateReaderByID"}}}},"summary":"Create a Reader","tags":["Readers"],"x-permissions":["readers_create"],"x-scopes":["readers.write"]}},"/v0.1/merchants/{merchant_code}/readers/{id}":{"delete":{"description":"Deletes a Reader.\n","operationId":"DeleteReader","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"The unique identifier of the reader.\n","in":"path","name":"id","required":true,"schema":{"$ref":"#/components/schemas/ReaderID"}}],"responses":{"200":{"description":"The reader got successfully deleted from the merchant account.\n"}},"summary":"Delete a reader","tags":["Readers"],"x-permissions":["readers_delete"],"x-scopes":["readers.write"]},"get":{"description":"Gets a Reader.\n","operationId":"GetReader","parameters":[{"description":"Return the reader only if it has been modified after the specified timestamp given in the headers.\n\nTimestamps are accepted in the following formats:\n - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1).\n - RFC 3339: Used for timestamps in JSON payloads on this API.\n","in":"header","name":"If-Modified-Since","schema":{"oneOf":[{"example":"Tue, 03 May 2022 14:46:44 GMT","format":"httpdate","type":"string"},{"example":"2023-05-30T10:38:01+00:00","format":"date-time","type":"string"}],"type":"string"}},{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"The unique identifier of the reader.\n","in":"path","name":"id","required":true,"schema":{"$ref":"#/components/schemas/ReaderID"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Reader"}}},"description":"Reader object got returned.\n"},"400":{"description":"Malformed request."},"404":{"description":"The requested Reader resource does not exists.\n"}},"summary":"Retrieve a Reader","tags":["Readers"],"x-permissions":["readers_view"],"x-scopes":["readers.read"]},"patch":{"description":"Updates a Reader.\n","operationId":"UpdateReader","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"The unique identifier of the reader.\n","in":"path","name":"id","required":true,"schema":{"$ref":"#/components/schemas/ReaderID"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"name":{"$ref":"#/components/schemas/ReaderName"}},"type":"object"}}},"required":true},"responses":{"304":{"description":"The update request was successful, but the reader didn't get updated.\n"},"403":{"description":"The reader is not linked to the merchant account.\n"}},"summary":"Update a Reader","tags":["Readers"],"x-permissions":["readers_update"],"x-scopes":["readers.write"]}},"/v0.1/merchants/{merchant_code}/readers/{id}/checkout":{"post":{"callbacks":{"ReaderCheckoutStatusChange":{"{$request.body#/return_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReaderCheckoutStatusChange"}}}},"responses":{"200":{"description":"Your server returns this code if it accepts the callback.\nIf the server returns any other code, the callback will be retried up to 5 times with exponential backoff.\n"}}}}}},"description":"Create a Checkout for a Reader.\n\nThis process is asynchronous and the actual transaction may take some time to be stared on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise checkout won't be accepted\n* After the checkout is accepted, the system has 60 seconds to start the payment on the target device. During this time, any other checkout for the same device will be rejected.\n\n**Note**: If the target device is a Solo, it must be in version 3.3.24.3 or higher.\n","operationId":"CreateReaderCheckout","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"The unique identifier of the reader.\n","in":"path","name":"id","required":true,"schema":{"example":"rdr_3MSAFM23CK82VSTT4BN6RWSQ65","maxLength":30,"minLength":30,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReaderCheckout"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"data":{"properties":{"client_transaction_id":{"description":"The client transaction ID is a unique identifier for the transaction that is generated for the client.\nIt can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get).\n","example":"123e4567-e89b-12d3-a456-426614174000","format":"uuid","type":"string"}},"type":"object"}},"type":"object"}}},"description":"The Checkout got successfully created for the given reader.\n"},"400":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Bad Request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Bad Request"},"422":{"content":{"application/json":{"examples":{"DataValidation":{"description":"Validation errors for the informed fields.","value":{"errors":{"card_type":["is invalid"],"installments":["not allowed"],"total_amount":["is too low","this merchant can only accept 'EUR'"]}}},"ReaderCheckoutPending":{"description":"Error returned when a checkout was requested in the last 60 seconds.","value":{"errors":{"detail":"A pending transaction already exists for this device"}}},"ReaderOffline":{"description":"Error returned when the target device is not online.","value":{"errors":{"detail":"The device is offline.","type":"READER_OFFLINE"}}}},"schema":{"properties":{"errors":{"additionalProperties":true,"type":"object"}},"type":"object"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Internal Server Error","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Bad Gateway","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Bad Gateway"},"504":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Gateway Timeout","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Gateway Timeout"}},"summary":"Create a Reader Checkout","tags":["Readers"],"x-permissions":["readers_checkout_create"],"x-scopes":["readers.write"]}},"/v0.1/merchants/{merchant_code}/readers/{id}/terminate":{"post":{"description":"Create a Terminate action for a Reader.\n\nIt stops the current transaction on the target device.\n\nThis process is asynchronous and the actual termination may take some time to be performed on the device.\n\n\nThere are some caveats when using this endpoint:\n* The target device must be online, otherwise terminate won't be accepted\n* The action will succeed only if the device is waiting for cardholder action: e.g: waiting for card, waiting for PIN, etc.\n* There is no confirmation of the termination.\n\nIf a transaction is successfully terminated and `return_url` was provided on Checkout, the transaction status will be sent as `failed` to the provided URL.\n\n**Note**: If the target device is a Solo, it must be in version 3.3.28.0 or higher.\n","operationId":"CreateReaderTerminate","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"The unique identifier of the reader.\n","in":"path","name":"id","required":true,"schema":{"example":"rdr_3MSAFM23CK82VSTT4BN6RWSQ65","maxLength":30,"minLength":30,"type":"string"}}],"responses":{"202":{"description":"The Terminate action was successfully dispatched for the given reader.\n"},"422":{"content":{"application/json":{"examples":{"ReaderOffline":{"description":"Error returned when the target device is not online.","value":{"errors":{"detail":"The device is offline.","type":"READER_OFFLINE"}}}},"schema":{"properties":{"errors":{"additionalProperties":true,"type":"object"}},"type":"object"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Internal Server Error","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Bad Gateway","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Bad Gateway"},"504":{"content":{"application/json":{"schema":{"properties":{"errors":{"properties":{"detail":{"example":"Gateway Timeout","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Gateway Timeout"}},"summary":"Create a Reader Terminate action","tags":["Readers"],"x-permissions":["readers_checkout_create"],"x-scopes":["readers.write"]}},"/v1.1/merchants/{merchant_code}/bank-accounts":{"get":{"description":"Retrieves bank accounts of the merchant.","operationId":"ListBankAccountsV11","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"If true only the primary bank account (the one used for payouts) will be returned.","in":"query","name":"primary","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BankAccount"},"type":"array"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"examples":{"Forbidden":{"description":"You do not have required scopes for making this request.","value":{"error_code":"FORBIDDEN","error_message":"request_not_allowed","status_code":"403"}}},"schema":{"$ref":"#/components/schemas/ErrorForbidden"}}},"description":"Forbidden"}},"summary":"List bank accounts","tags":["Merchant"],"x-codegen":{"method_name":"list_bank_accounts"},"x-scopes":["user.payout-settings","user.profile","user.profile_readonly"]}},"/v1.1/receipts/{id}":{"get":{"description":"Retrieves receipt specific data for a transaction.","operationId":"GetReceipt","parameters":[{"description":"SumUp unique transaction ID or transaction code, e.g. TS7HDYLSKD.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Merchant code.","in":"query","name":"mid","required":true,"schema":{"type":"string"}},{"description":"The ID of the transaction event (refund).","in":"query","name":"tx_event_id","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}},"description":"OK"},"400":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"Retrieve receipt details","tags":["Receipts"],"x-codegen":{"method_name":"get"},"x-scopes":[]}},"/v2.1/merchants/{merchant_code}/transactions":{"get":{"description":"Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required:\n * `id`\n * `internal_id`\n * `transaction_code`\n * `foreign_transaction_id`\n * `client_transaction_id`\n","operationId":"GetTransactionV2.1","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource).","in":"query","name":"id","schema":{"type":"string"}},{"description":"Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource).","in":"query","name":"internal_id","schema":{"type":"string"}},{"description":"Retrieves the transaction resource with the specified transaction code.","in":"query","name":"transaction_code","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionFull"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"examples":{"Not_Found":{"description":"The identified resource is not found on the server.","value":{"error_code":"NOT_FOUND","message":"Resource not found"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found"}},"summary":"Retrieve a transaction","tags":["Transactions"],"x-codegen":{"method_name":"get"},"x-scopes":["transactions.history"]}},"/v2.1/merchants/{merchant_code}/transactions/history":{"get":{"description":"Lists detailed history of all transactions associated with the merchant profile.","operationId":"ListTransactionsV2.1","parameters":[{"in":"path","name":"merchant_code","required":true,"schema":{"example":"MC0X0ABC","type":"string"}},{"description":"Retrieves the transaction resource with the specified transaction code.","in":"query","name":"transaction_code","schema":{"type":"string"}},{"description":"Specifies the order in which the returned results are displayed.","in":"query","name":"order","schema":{"default":"ascending","enum":["ascending","descending"],"type":"string"}},{"description":"Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Filters the returned results by user email.","in":"query","name":"users","schema":{"items":{"format":"email","type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of final statuses of the transactions.","in":"query","name":"statuses","schema":{"items":{"enum":["SUCCESSFUL","CANCELLED","FAILED","REFUNDED","CHARGE_BACK"],"type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of payment types used for the transactions.","in":"query","name":"payment_types","schema":{"items":{"enum":["CASH","POS","ECOM","BALANCE","MOTO","BOLETO","UNKNOWN"],"type":"string"},"type":"array"}},{"description":"Filters the returned results by the specified list of transaction types.","in":"query","name":"types","schema":{"items":{"enum":["PAYMENT","REFUND","CHARGE_BACK"],"type":"string"},"type":"array"}},{"description":"Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"changes_since","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"newest_time","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request).","in":"query","name":"newest_ref","schema":{"type":"string"}},{"description":"Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).","in":"query","name":"oldest_time","schema":{"format":"date-time","type":"string"}},{"description":"Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request).","in":"query","name":"oldest_ref","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TransactionHistory"},"type":"array"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"}},"type":"object"}}},"description":"OK"},"401":{"content":{"application/json":{"examples":{"Invalid_Token":{"description":"The access token is invalid or has expired.","value":{"error_code":"NOT_AUTHORIZED","error_message":"invalid access token"}},"Missing_Token":{"description":"No access token is provided.","value":{"error_code":"NOT_AUTHORIZED","message":"access token required"}},"Not_Authorized_Token":{"description":"The access token is valid but the application is not authorized.","value":{"error_code":"NOT_AUTHORIZED","error_message":"NOT_AUTHORIZED"}}},"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"}},"summary":"List transactions","tags":["Transactions"],"x-codegen":{"method_name":"list"},"x-scopes":["transactions.history"]}}},"servers":[{"description":"Production server","url":"https://api.sumup.com"}],"tags":[{"description":"SumUp API uses [API keys](/online-payments/introduction/authorization#api-keys) for authentication.\nYou can view and manage your API keys in the [API Keys](/api-keys) section of the [Developer Portal](/).\n\n\nAPI keys are short static tokens that are passed in the `Authorization` header to authenticate the requests.\n\n\nThe tokens have a `sup_sk_` prefix. Your API keys have access to the whole SumUp API, so make sure to keep them secure.\n\n\nAll requests must be made over [HTTPS](https://en.wikipedia.org/wiki/HTTPS) and must be authenticated.\n\n\nAlternatively, SumUp APIs support [OAuth2](/online-payments/introduction/authorization#oauth-20) authentication for applications that want to use SumUp as a platform for other users.\n\n\nRead more about authorization in our [Authorization guide](/online-payments/introduction/authorization).\n","name":"Authorization"},{"description":"Accept payments from your end users by adding the Checkouts model to your platform.\nSumUp supports standard and single payment 3DS checkout flows.\n\nThe Checkout model allows creating, listing, retrieving, processing and deactivating checkouts.\nA payment is completed by creating a checkout and then processing the checkout.\n","name":"Checkouts","x-core-objects":[{"$ref":"#/components/schemas/Checkout"}]},{"description":"Allow your regular customers to save their information with the Customers model.\nThis will prevent re-entering payment instrument information for recurring payments on your platform.\n\nDepending on the needs you can allow, creating, listing or deactivating payment instruments \u0026 creating, retrieving and updating customers.\n","name":"Customers","x-core-objects":[{"$ref":"#/components/schemas/Customer"}]},{"description":"Retrieve details for a specific transaction by it’s `id`\nor any other required query parameter, or list all transactions related to the merchant account.\n","name":"Transactions"},{"description":"The Payouts model will allow you to track funds you’ve received from SumUp.\nYou can receive a detailed payouts list with information like dates, fees, references and statuses, using the `List payouts` endpoint.\n","name":"Payouts","x-core-objects":[{"$ref":"#/components/schemas/FinancialPayouts"}]},{"description":"The Receipts model obtains receipt-like details for specific transactions.","name":"Receipts","x-core-objects":[{"$ref":"#/components/schemas/Receipt"}]},{"description":"Manage merchant profile.","name":"Merchant","x-core-objects":[{"$ref":"#/components/schemas/MerchantAccount"}]},{"description":"API Keys allow your application to gain programmatic access to SumUp.\nAPI Keys allow application to do authorized requests within the SumUp ecosystem. API Keys are scopes to single account and thus can't be used for endpoints where user presence is needed (for such endpoints it is necessary to use OAuth2).\n","name":"API Keys","x-core-objects":[{"$ref":"#/components/schemas/APIKey"}]},{"description":"Endpoints for managing merchant sub-accounts (operators).\n","name":"Subaccounts","x-core-objects":[{"$ref":"#/components/schemas/Operator"}]},{"description":"Endpoints to manage account members. Members are users that have membership within merchant accounts.\n","name":"Members","x-beta":true,"x-core-objects":[{"$ref":"#/components/schemas/Member"}]},{"description":"A reader represents a device that accepts payments. You can use the SumUp Solo to accept in-person payments.\n","name":"Readers","x-beta":true,"x-core-objects":[{"$ref":"#/components/schemas/Reader"}]}]} diff --git a/openapi.yaml b/openapi.yaml new file mode 100644 index 0000000..6c543f9 --- /dev/null +++ b/openapi.yaml @@ -0,0 +1,6115 @@ +openapi: 3.0.1 +info: + description: | + SumUp’s REST API operates with `application/json` HTTP requests and response. The request bodies are sent through resource-oriented URLs and use the standard HTTP response codes. + For testing our APIs make sure you have a SumUp Profile (you can create one [here](https://me.sumup.com)). To activate your SumUp Profile [follow these steps](https://help.sumup.com/en-GB/articles/7gSOGSm2wEwIHyAvjitrLF). + + Once you have an active SumUp Profile, go to [developer.sumup.com](https://developer.sumup.com/) and click on “Create” On the top right side, click on “Profile” followed by “Test profiles” Select your business country Click “Create” Copy and store safely the user name (format: 32 characters@developers.sumup.com) and randomly generated unique password. + + Note: You will not be able to access your password afterwards make sure to store it safely before dismissing the message + + Note: SumUp merchants are able to create up to 20 test profiles + + When you receive your test profile you can create your [client credentials](https://developer.sumup.com/docs/register-app/#3-create-oauth-client-credentials) and process different requests with real payment instruments, without charging them. + Legal note: We reserve the right to change, modify, or remove the contents of this Website and SumUp APIs at any time without notice. + title: SumUp REST API + version: 1.0.0 +servers: + - description: Production server + url: 'https://api.sumup.com' +paths: + /authorize: + get: + operationId: Authorize + summary: Request authorization from users + description: | + Request authorization from users and grant your application access to resources associated with the user's profile. + parameters: + - name: response_type + in: query + description: The type of the expected response. The value must be `code` to indicate that you expect to receive an authorization code. + schema: + type: string + example: code + - name: client_id + in: query + description: 'The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app/).' + schema: + type: string + example: fOcmczrYtYMJ7Li5GjMLLcUeC9dN + - name: redirect_uri + in: query + description: 'The URI to which the merchant user is redirected after authorizing your application to access their user''s profile data and to which the authorization code is sent. The value must match exactly one of the [registered URIs](https://developer.sumup.com/docs/register-app#3-create-oauth-client-credentials) for your application.' + schema: + type: string + example: 'https://sample-app.example.com/callback' + - name: scope + in: query + description: 'A space-separated list of scopes for which you request authorization. If you don''t specify any scopes in the request, your application will be granted authorization for the default scopes.' + schema: + type: string + example: payments + - name: state + in: query + description: 'A unique local state that can be used for correlating requests and responses and for preventing [cross-site request forgery](https://tools.ietf.org/html/rfc6749#section-10.12).' + schema: + type: string + example: 2cFCsY36y95lFHk4 + responses: + '200': + description: No Content + content: + application/json: + examples: + NoBody: + value: {} + schema: + type: object + tags: + - Authorization + /token: + post: + operationId: CreateToken + summary: Generate a token + description: | + Generate a token or a refresh token + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AuthToken' + responses: + '200': + description: OK + content: + application/json: + examples: + access_token: + description: Successfully created access token + value: + access_token: 565e2d19cef68203170ddadb952141326d14e03f4ccbd46daa079c26c910a864 + expires_in: 3600 + refresh_token: d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af + token_type: Bearer + refresh_token: + description: Successfully created access token with the refresh token + value: + access_token: ec410d10ad7f06d3c2598473c9cd61189abcc016900a9938068542bcf9754073 + expires_in: 3600 + refresh_token: d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af + scope: payments user.app-settings transactions.history user.profile_readonly + token_type: Bearer + schema: + type: object + properties: + access_token: + description: The access token that you need to use in your requests to the SumUp API. + type: string + example: ec410d10ad7f06d3c2598473c9cd61189abcc016900a9938068542bcf9754073 + expires_in: + description: The validity of the access token in seconds. + type: integer + example: 3600 + refresh_token: + description: The refresh token provided in the request call + type: string + example: d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af + scope: + description: List of authorization scopes granted to your access token. + type: string + example: payments user.app-settings transactions.history user.profile_readonly + token_type: + description: The type of the token. The value is always `Bearer`. + type: string + example: Bearer + '400': + description: Bad Request + content: + application/json: + examples: + Invalid_Parameter: + description: A parameter is invalid or expired. + value: + error: invalid_grant + error_description: code parameter invalid or expired + Missing_Parameter: + description: A parameter is missing in the request. + value: + error: invalid_request + error_description: code parameter is missing + schema: + $ref: '#/components/schemas/Error' + tags: + - Authorization + /v0.1/checkouts: + get: + operationId: ListCheckouts + summary: List checkouts + description: Lists created checkout resources according to the applied `checkout_reference`. + parameters: + - name: checkout_reference + in: query + description: Filters the list of checkout resources by the unique ID of the checkout. + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/CheckoutSuccess' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: list + x-scopes: + - payments + post: + operationId: CreateCheckout + summary: Create a checkout + description: | + Creates a new payment checkout resource. The unique `checkout_reference` created by this request, is used for further manipulation of the checkout. + + For 3DS checkouts, add the `redirect_url` parameter to your request body schema. + + Follow by processing a checkout to charge the provided payment instrument. + requestBody: + content: + application/json: + examples: + Checkout: + description: Standard request body for creating a checkout + value: + amount: 10.1 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + date: '2020-02-29T10:56:56+00:00' + description: Purchase + id: 2b79757a-de87-4a2e-90e4-b17c947c730d + merchant_code: MDUDGLR9 + merchant_name: John Doe LTD + pay_to_email: user@example.com + redirect_url: 'https://sumup.com' + status: PAID + Checkout3DS: + description: Create a 3DS checkout + value: + amount: 10.1 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + customer_id: 831ff8d4cd5958ab5670 + description: Purchase + merchant_code: MH4H92C7 + pay_to_email: user@example.com + redirect_url: 'https://mysite.com/completed_purchase' + return_url: 'http://example.com/' + CheckoutAPM: + description: Create an Alternative Payment Method checkout + value: + amount: 10.1 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + merchant_code: MH4H92C7 + redirect_url: 'https://mysite.com/completed_purchase' + schema: + $ref: '#/components/schemas/CheckoutCreateRequest' + responses: + '201': + description: Created + content: + application/json: + examples: + Checkout: + description: Standard response body for a successfully created checkout + value: + amount: 10.1 + checkout_reference: 8ea25ec3-3293-40e9-a165-6d7f3b3073c5 + currency: EUR + customer_id: 831ff8d4cd5958ab5670 + date: '2020-02-29T10:56:56+00:00' + description: My Checkout + id: 88fcf8de-304d-4820-8f1c-ec880290eb92 + mandate: + merchant_code: MDASYTPD + status: active + type: recurrent + merchant_code: MCNPLE22 + merchant_country: DE + pay_to_email: user@example.com + return_url: 'http://example.com' + status: PENDING + transactions: + - amount: 10.1 + auth_code: '012345' + currency: EUR + entry_mode: CUSTOMER_ENTRY + id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + installments_count: 1 + internal_id: 0 + merchant_code: MH4H92C7 + payment_type: ECOM + status: SUCCESSFUL + timestamp: '2020-02-29T10:56:56.876Z' + tip_amount: 3 + transaction_code: TEENSK4W2K + vat_amount: 6 + valid_until: '2020-02-29T10:56:56+00:00' + Checkout3DS: + description: Response body for a successfully created 3DS checkout + value: + amount: 10.1 + checkout_reference: 8ea25ec3-3293-40e9-a165-6d7f3b3073c5 + currency: EUR + customer_id: 831ff8d4cd5958ab5670 + date: '2020-02-29T10:56:56+00:00' + description: My Checkout + id: 88fcf8de-304d-4820-8f1c-ec880290eb92 + pay_to_email: user@example.com + redirect_url: 'https://mysite.com/completed_purchase' + return_url: 'http://example.com' + status: PENDING + transactions: + - amount: 10.1 + auth_code: '012345' + currency: EUR + entry_mode: CUSTOMER_ENTRY + id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + installments_count: 1 + internal_id: 0 + merchant_code: MH4H92C7 + payment_type: ECOM + status: SUCCESSFUL + timestamp: '2020-02-29T10:56:56.876Z' + tip_amount: 3 + transaction_code: TEENSK4W2K + vat_amount: 6 + valid_until: '2020-02-29T10:56:56+00:00' + CheckoutAPM: + description: 'Response body for APMs, including Blik, iDeal, ...' + value: + amount: 10.1 + checkout_reference: 8ea25ec3-3293-40e9-a165-6d7f3b3073c5 + currency: EUR + date: '2021-06-29T11:08:36.000+00:00' + description: My Checkout + id: 88fcf8de-304d-4820-8f1c-ec880290eb92 + merchant_code: MCNPLE22 + merchant_country: DE + merchant_name: My company + pay_to_email: user@example.com + purpose: CHECKOUT + redirect_url: 'https://sumup.com' + return_url: 'http://example.com' + status: PENDING + transactions: + - amount: 10.1 + auth_code: '012345' + currency: EUR + entry_mode: CUSTOMER_ENTRY + id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + installments_count: 1 + internal_id: 0 + merchant_code: MH4H92C7 + payment_type: ECOM + status: SUCCESSFUL + timestamp: '2020-02-29T10:56:56.876Z' + tip_amount: 3 + transaction_code: TEENSK4W2K + vat_amount: 6 + schema: + $ref: '#/components/schemas/Checkout' + '400': + description: Bad Request + content: + application/json: + examples: + Missing_Parameter: + description: A required parameter is missing. + value: + error_code: MISSING + message: Validation error + param: pay_to_email + schema: + $ref: '#/components/schemas/ErrorExtended' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have the required permission for making this request. + value: + error_code: FORBIDDEN + error_message: checkout_payments_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '409': + description: Conflict + content: + application/json: + examples: + Existing_Checkout: + description: A resource with the specified parameters already exists on the server. + value: + error_code: DUPLICATED_CHECKOUT + message: Checkout with this checkout reference and pay to email already exists + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: create + x-scopes: + - payments + '/v0.1/checkouts/{id}': + delete: + operationId: DeactivateCheckout + summary: Deactivate a checkout + description: Deactivates an identified checkout resource. If the checkout has already been processed it can not be deactivated. + responses: + '200': + description: OK + content: + application/json: + examples: + DeletedCheckout: + description: Response body for a successfully deactivated checkout + value: + amount: 2 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + date: '2020-02-29T10:56:56+00:00' + description: Deletion example + id: 817340ce-f1d9-4609-b90a-6152f8ee267j + merchant_code: MH4H92C7 + merchant_name: Sample Merchant + pay_to_email: user@example.com + purpose: CHECKOUT + status: EXPIRED + transactions: [] + valid_until: '2020-02-29T10:56:56+00:00' + schema: + description: Details of the deleted checkout. + type: object + properties: + amount: + description: Amount of the payment. + type: number + format: float + checkout_reference: + description: Unique ID of the payment checkout specified by the client application when creating the checkout resource. + type: string + maxLength: 90 + currency: + $ref: '#/components/schemas/Currency' + date: + description: 'Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + readOnly: true + description: + description: 'Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.' + type: string + id: + description: Unique ID of the checkout resource. + type: string + readOnly: true + merchant_code: + description: Unique identifying code of the merchant profile. + type: string + merchant_country: + description: The merchant's country + type: string + merchant_name: + description: Merchant name + type: string + pay_to_email: + description: Email address of the registered user (merchant) to whom the payment is made. It is highly recommended to use `merchant_code` instead of `pay_to_email`. + type: string + format: email + purpose: + description: Purpose of the checkout creation initially + type: string + enum: + - SETUP_RECURRING_PAYMENT + - CHECKOUT + status: + description: Current status of the checkout. + type: string + enum: + - EXPIRED + readOnly: true + transactions: + description: List of transactions related to the payment. + type: array + items: + allOf: + - $ref: '#/components/schemas/TransactionMixinBase' + - $ref: '#/components/schemas/TransactionMixinCheckout' + readOnly: true + uniqueItems: true + valid_until: + description: 'Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + nullable: true + readOnly: true + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + '409': + description: Conflict + content: + application/json: + examples: + Checkout_Processed: + description: The identified checkout resource is already processed. + value: + error_code: CHECKOUT_PROCESSED + message: Checkout is already processed + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: deactivate + x-scopes: + - payments + get: + operationId: GetCheckout + summary: Retrieve a checkout + description: Retrieves an identified checkout resource. Use this request after processing a checkout to confirm its status and inform the end user respectively. + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/CheckoutSuccess' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: get + x-scopes: + - payments + parameters: + - name: id + in: path + description: Unique ID of the checkout resource. + required: true + schema: + type: string + put: + operationId: ProcessCheckout + summary: Process a checkout + description: | + Processing a checkout will attempt to charge the provided payment instrument for the amount of the specified checkout resource initiated in the `Create a checkout` endpoint. + + Follow this request with `Retrieve a checkout` to confirm its status. + requestBody: + description: Details of the payment instrument for processing the checkout. + content: + application/json: + examples: + ProcessBancontact: + description: Process a checkout with Bancontact + value: + payment_type: bancontact + personal_details: + address: + country: BE + email: user@example.com + first_name: John + last_name: Doe + ProcessBoleto: + description: Process a checkout with Boleto + value: + payment_type: boleto + personal_details: + address: + city: São Paulo + country: BR + line1: 'Rua Gilberto Sabino, 215' + postal_code: 05425-020 + state: SP + email: user@example.com + first_name: John + last_name: Doe + tax_id: 423.378.593-47 + ProcessCard: + description: Process a checkout with a card + value: + card: + cvv: '123' + expiry_month: '01' + expiry_year: '2023' + last_4_digits: '3456' + name: John Doe + number: '1234567890123456' + type: VISA + zip_code: '12345' + installments: 1 + mandate: + type: recurrent + user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36' + user_ip: 172.217.169.174 + payment_type: card + ProcessToken: + description: Process a checkout with a token + value: + customer_id: MEDKHDTI + installments: 1 + payment_type: card + token: ba85dfee-c3cf-48a6-84f5-d7d761fbba50 + ProcessiDeal: + description: Process a checkout with iDeal + value: + payment_type: ideal + personal_details: + address: + country: NL + email: user@example.com + first_name: John + last_name: Doe + schema: + $ref: '#/components/schemas/CheckoutProcessMixin' + responses: + '200': + description: OK + content: + application/json: + examples: + CheckoutSuccessBancontact: + description: Successfully processed checkout with Bancontact + value: + next_step: + full: 'https://r3.girogate.de/ti/simbcmc?tx=624788471&rs=5MioXoKt2Gwj9dLgqAX1bMRBuT5xTSdB&cs=697edacdd9175f3f99542500fa0ff08280b66aaff3c2641a2e212e4b039473cc' + mechanism: + - browser + method: GET + payload: + cs: 697edacdd9175f3f99542500fa0ff08280b66aaff3c2641a2e212e4b039473cc + rs: 5MioXoKt2Gwj9dLgqAX1bMRBuT5xTSdB + tx: '624788471' + url: 'https://r3.girogate.de/ti/simbcmc' + CheckoutSuccessBoleto: + description: Successfully processed checkout with Boleto + value: + amount: 10.1 + boleto: + barcode: '34191090081790614310603072340007886840000000200' + url: 'https://checkouts.sample.com/v0.1/checkouts/2e7a36cc-7897-446b-a966-952ab5f049ea/boleto' + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: BRL + date: '2021-07-06T12:34:02.000+00:00' + description: Boleto checkout + id: 4e425463-3e1b-431d-83fa-1e51c2925e99 + merchant_code: MH4H92C7 + merchant_name: Sample shop + pay_to_email: user@example.com + purpose: CHECKOUT + redirect_url: 'https://website.com' + status: PENDING + transactions: + - amount: 10.1 + currency: BRL + entry_mode: BOLETO + id: debd2986-9852-4e86-8a8e-7ea9c87dd679 + installments_count: 1 + internal_id: 1763892018 + merchant_code: MH4H92C9 + payment_type: BOLETO + status: PENDING + timestamp: '2021-07-06T12:34:16.460+00:00' + tip_amount: 3 + transaction_code: TEN3E696NP + vat_amount: 6 + CheckoutSuccessCard: + description: Successfully processed checkout with a card + value: + amount: 10.1 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + customer_id: 831ff8d4cd5958ab5670 + date: '2020-02-29T10:56:56+00:00' + description: Purchase + id: 4e425463-3e1b-431d-83fa-1e51c2925e99 + mandate: + merchant_code: MDASYTPD + status: active + type: recurrent + merchant_code: MH4H92C7 + pay_to_email: user@example.com + return_url: 'http://example.com' + status: PENDING + transaction_code: TEENSK4W2K + transaction_id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + transactions: + - amount: 10.1 + auth_code: '053201' + currency: EUR + entry_mode: CUSTOMER_ENTRY + id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + installments_count: 1 + internal_id: 1763892018 + merchant_code: MH4H92C7 + payment_type: ECOM + status: SUCCESSFUL + timestamp: '2020-02-29T10:56:56.876Z' + tip_amount: 3 + transaction_code: TEENSK4W2K + vat_amount: 6 + valid_until: '2020-02-29T10:56:56+00:00' + CheckoutSuccessToken: + description: Successfully processed checkout with a token + value: + amount: 10.1 + checkout_reference: f00a8f74-b05d-4605-bd73-2a901bae5802 + currency: EUR + customer_id: 831ff8d4cd5958ab5670 + date: '2020-02-29T10:56:56+00:00' + description: Purchase with token + id: 4e425463-3e1b-431d-83fa-1e51c2925e99 + merchant_code: MH4H92C7 + merchant_name: Sample Merchant + pay_to_email: user@example.com + payment_instrument: + token: e76d7e5c-9375-4fac-a7e7-b19dc5302fbc + redirect_url: 'https://mysite.com/completed_purchase' + status: PENDING + transaction_code: TEENSK4W2K + transaction_id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + transactions: + - amount: 10.1 + auth_code: '053201' + currency: EUR + entry_mode: CUSTOMER_ENTRY + id: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + installments_count: 1 + internal_id: 1763892018 + merchant_code: MH4H92C7 + payment_type: ECOM + status: SUCCESSFUL + timestamp: '2020-02-29T10:56:56.876Z' + tip_amount: 3 + transaction_code: TEENSK4W2K + vat_amount: 6 + CheckoutSuccessiDeal: + description: Successfully processed checkout with iDeal + value: + next_step: + full: 'https://r3.girogate.de/ti/simideal?tx=961473700&rs=ILnaUeQTKJ184fVrjGILrLjePX9E4rmz&cs=c8bc0ea231f8372431ca22d6f8319f8de0263d0b1705759ed27155f245f193c5' + mechanism: + - browser + method: GET + payload: + cs: c8bc0ea231f8372431ca22d6f8319f8de0263d0b1705759ed27155f245f193c5 + rs: ILnaUeQTKJ184fVrjGILrLjePX9E4rmz + tx: '961473700' + url: 'https://r3.girogate.de/ti/simideal' + schema: + $ref: '#/components/schemas/CheckoutSuccess' + '400': + description: Bad Request + content: + application/json: + examples: + Invalid_Parameter: + description: A required parameter has an invalid value. + value: + error_code: INVALID + message: Validation error + param: card.expiry_year + Multiple_Invalid_Parameters: + description: Multiple required parameters have invalid values. + value: + - error_code: INVALID + message: Validation error + param: card.name + - error_code: INVALID + message: Validation error + param: card.number + - error_code: INVALID + message: Validation error + param: card.expiry_year + schema: + oneOf: + - $ref: '#/components/schemas/ErrorExtended' + - description: List of error messages. + items: + $ref: '#/components/schemas/ErrorExtended' + type: array + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + '409': + description: Conflict + content: + application/json: + examples: + Checkout_Processed: + description: The identified checkout resource is already processed. + value: + error_code: CHECKOUT_PROCESSED + message: Checkout is already processed + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: process + /v0.1/customers: + post: + operationId: CreateCustomer + summary: Create a customer + description: Creates a new saved customer resource which you can later manipulate and save payment instruments to. + requestBody: + description: Details of the customer. + content: + application/json: + schema: + $ref: '#/components/schemas/Customer' + responses: + '201': + description: Created + content: + application/json: + schema: + $ref: '#/components/schemas/Customer' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '409': + description: Conflict + content: + application/json: + examples: + Existing_Customer: + description: A resource with the specified identifier already exists on the server. + value: + error_code: CUSTOMER_ALREADY_EXISTS + message: Customer already exists + schema: + $ref: '#/components/schemas/Error' + tags: + - Customers + x-codegen: + method_name: create + x-scopes: + - payment_instruments + '/v0.1/customers/{customer_id}': + get: + operationId: GetCustomer + summary: Retrieve a customer + description: 'Retrieves an identified saved customer resource through the unique `customer_id` parameter, generated upon customer creation.' + responses: + '200': + description: Created + content: + application/json: + schema: + $ref: '#/components/schemas/Customer' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Customers + x-codegen: + method_name: get + x-scopes: + - payment_instruments + parameters: + - name: customer_id + in: path + description: Unique ID of the saved customer resource. + required: true + schema: + type: string + put: + operationId: UpdateCustomer + summary: Update a customer + description: | + Updates an identified saved customer resource's personal details. + + The request only overwrites the parameters included in the request, all other parameters will remain with their initially assigned values. + requestBody: + content: + application/json: + schema: + type: object + properties: + personal_details: + $ref: '#/components/schemas/PersonalDetails' + responses: + '200': + description: Created + content: + application/json: + schema: + $ref: '#/components/schemas/Customer' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Customers + x-codegen: + method_name: update + x-scopes: + - payment_instruments + '/v0.1/customers/{customer_id}/payment-instruments': + get: + operationId: ListPaymentInstruments + summary: List payment instruments + description: Lists all payment instrument resources that are saved for an identified customer. + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/PaymentInstrumentResponse' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Customers + x-codegen: + method_name: list_payment_instruments + x-scopes: + - payment_instruments + parameters: + - name: customer_id + in: path + description: Unique ID of the saved customer resource. + required: true + schema: + type: string + '/v0.1/customers/{customer_id}/payment-instruments/{token}': + delete: + operationId: DeactivatePaymentInstrument + summary: Deactivate a payment instrument + description: Deactivates an identified card payment instrument resource for a customer. + responses: + '204': + description: No Content + content: + application/json: + examples: + NoBody: + value: {} + schema: + type: object + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Customers + x-codegen: + method_name: deactivate_payment_instrument + x-scopes: + - payment_instruments + parameters: + - name: customer_id + in: path + description: Unique ID of the saved customer resource. + required: true + schema: + type: string + - name: token + in: path + description: Unique token identifying the card saved as a payment instrument resource. + required: true + schema: + type: string + /v0.1/me: + get: + operationId: GetAccount + summary: Retrieve a profile + description: Returns user profile information. + parameters: + - name: 'include[]' + in: query + description: A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned. + schema: + type: array + items: + enum: + - settings + - doing_business_as + - bank_accounts + - app_settings + - country_details + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/MerchantAccount' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Merchant + x-codegen: + method_name: get + x-scopes: + - user.profile + - user.profile_readonly + /v0.1/me/accounts: + get: + operationId: ListSubAccounts + summary: List operators. + description: Returns list of operators for currently authorized user's merchant. + parameters: + - name: query + in: query + description: | + Search query used to filter users that match given query term. + + Current implementation allow querying only over the email address. + All operators whos email address contains the query string are returned. + schema: + type: string + - name: include_primary + in: query + description: If true the list of operators will include also the primary user. + schema: + type: boolean + responses: + '200': + description: List of operators. + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/Operator' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_list + x-scopes: [] + post: + operationId: CreateSubAccount + summary: Create operator. + description: Creates new operator for currently authorized users' merchant. + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + nickname: + type: string + example: Operator 1 + password: + type: string + example: correct horse batter staple + minLength: 8 + permissions: + type: object + properties: + create_moto_payments: + type: boolean + create_referral: + type: boolean + full_transaction_history_view: + type: boolean + refund_transactions: + type: boolean + username: + type: string + format: email + example: operator1@mydomain.com + required: + - username + - password + responses: + '200': + description: Newly created operator. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + '403': + description: error response for compat API calls + content: + application/json: + schema: + $ref: '#/components/schemas/CompatError' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_update + x-scopes: [] + '/v0.1/me/accounts/{operator_id}': + delete: + operationId: DeactivateSubAccount + summary: Disable operator. + parameters: + - name: operator_id + in: path + required: true + schema: + type: integer + format: int32 + responses: + '200': + description: Operator successfully disabled. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_delete + x-scopes: [] + get: + operationId: CompatGetOperator + summary: Get operator + description: Returns specific operator. + parameters: + - name: operator_id + in: path + required: true + schema: + type: integer + format: int32 + responses: + '200': + description: Operator. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_view + x-scopes: [] + put: + operationId: UpdateSubAccount + summary: Update operator. + description: Updates operator. If the operator was disabled and their password is updated they will be unblocked. + parameters: + - name: operator_id + in: path + required: true + schema: + type: integer + format: int32 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + disabled: + type: boolean + nickname: + type: string + example: Operator 1 + password: + type: string + example: correct horse batter staple + minLength: 8 + permissions: + type: object + properties: + create_moto_payments: + type: boolean + create_referral: + type: boolean + full_transaction_history_view: + type: boolean + refund_transactions: + type: boolean + username: + type: string + format: email + maxLength: 256 + responses: + '200': + description: Updated operator. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + '400': + description: Invalid Operators' email or password was already used. + content: + application/json: + schema: + $ref: '#/components/schemas/CompatError' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_update + x-scopes: [] + '/v0.1/me/accounts/{operator_id}/disable': + post: + operationId: CompatDisableOperator + summary: Disable operator. + parameters: + - name: operator_id + in: path + required: true + schema: + type: integer + format: int32 + responses: + '200': + description: Operator successfully disabled. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_write + x-scopes: [] + '/v0.1/me/accounts/{operator_id}/reset': + put: + operationId: CompatChangeOperatorsPassword + summary: Change operators password. + description: 'Changes operators password, if the operator was disabled they will be unblocked.' + parameters: + - name: operator_id + in: path + required: true + schema: + type: integer + format: int32 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + password: + type: string + example: correct horse batter staple + minLength: 8 + responses: + '200': + description: Operators' password successfully changed. + content: + application/json: + schema: + $ref: '#/components/schemas/Operator' + '400': + description: Operators' password was already used. + content: + application/json: + schema: + $ref: '#/components/schemas/CompatError' + deprecated: true + tags: + - Subaccounts + x-permissions: + - members_write + x-scopes: [] + /v0.1/me/financials/payouts: + get: + operationId: ListPayouts + summary: List payouts + description: Lists ordered payouts for the merchant profile. + parameters: + - name: start_date + in: query + description: 'Start date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + required: true + schema: + type: string + format: date + - name: end_date + in: query + description: 'End date (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + required: true + schema: + type: string + format: date + - name: format + in: query + schema: + type: string + enum: + - json + - csv + - name: limit + in: query + schema: + type: integer + - name: order + in: query + schema: + type: string + enum: + - desc + - asc + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/FinancialPayouts' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Payouts + x-codegen: + method_name: list + x-scopes: + - user.profile + - user.profile_readonly + /v0.1/me/merchant-profile: + get: + operationId: GetMerchantProfile + summary: Retrieve a merchant profile + description: Retrieves merchant profile data. + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/MerchantProfile' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + tags: + - Merchant + x-codegen: + method_name: get_merchant_profile + x-scopes: + - user.profile + - user.profile_readonly + /v0.1/me/merchant-profile/bank-accounts: + get: + operationId: ListBankAccounts + summary: List bank accounts (deprecated) + description: Retrieves bank accounts of the merchant. + parameters: + - name: primary + in: query + description: If true only the primary bank account (the one used for payouts) will be returned. + schema: + type: boolean + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/BankAccount' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + deprecated: true + tags: + - Merchant + x-codegen: + method_name: list_bank_accounts_deprecated + x-scopes: + - user.payout-settings + - user.profile + - user.profile_readonly + /v0.1/me/merchant-profile/doing-business-as: + get: + operationId: GetDoingBusinessAs + summary: Retrieve DBA + description: Retrieves Doing Business As profile. + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/DoingBusinessAs' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Merchant + x-codegen: + method_name: get_doing_business_as + x-scopes: + - user.profile + - user.profile_readonly + /v0.1/me/merchant-profile/settings: + get: + operationId: GetSettings + summary: Get settings + description: Retrieves merchant settings. + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/MerchantSettings' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + tags: + - Merchant + x-codegen: + method_name: get_settings + x-scopes: + - user.payout-settings + /v0.1/me/personal-profile: + get: + operationId: GetPersonalProfile + summary: Retrieve a personal profile + description: Retrieves personal profile data. + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/PersonalProfile' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Merchant + x-codegen: + method_name: get_personal_profile + x-scopes: + - user.profile + - user.profile_readonly + '/v0.1/me/refund/{txn_id}': + parameters: + - name: txn_id + in: path + description: Unique ID of the transaction. + required: true + schema: + type: string + post: + operationId: RefundTransaction + summary: Refund a transaction + description: Refunds an identified transaction either in full or partially. + requestBody: + content: + application/json: + schema: + description: Optional amount for partial refunds of transactions. + type: object + properties: + amount: + description: 'Amount to be refunded. Eligible amount can''t exceed the amount of the transaction and varies based on country and currency. If you do not specify a value, the system performs a full refund of the transaction.' + type: number + format: float + responses: + '204': + description: No Content + content: + application/json: + examples: + NoBody: + value: {} + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + '409': + description: Conflict + content: + application/json: + examples: + Transaction_Not_Refundable: + description: The state of the identified transaction resource does not permit the requested operation. + value: + error_code: CONFLICT + message: The transaction is not refundable in its current state + schema: + $ref: '#/components/schemas/Error' + tags: + - Transactions + x-codegen: + method_name: refund + x-scopes: + - payments + /v0.1/me/transactions: + get: + operationId: GetTransaction + summary: Retrieve a transaction (deprecated) + description: | + Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required: + * `id` + * `internal_id` + * `transaction_code` + * `foreign_transaction_id` + * `client_transaction_id` + parameters: + - name: id + in: query + description: Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource). + schema: + type: string + - name: internal_id + in: query + description: Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource). + schema: + type: string + - name: transaction_code + in: query + description: Retrieves the transaction resource with the specified transaction code. + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/TransactionFull' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + deprecated: true + tags: + - Transactions + x-codegen: + method_name: get_deprecated + x-scopes: + - transactions.history + /v0.1/me/transactions/history: + get: + operationId: ListTransactions + summary: List transactions (deprecated) + description: Lists detailed history of all transactions associated with the merchant profile. + parameters: + - name: transaction_code + in: query + description: Retrieves the transaction resource with the specified transaction code. + schema: + type: string + - name: order + in: query + description: Specifies the order in which the returned results are displayed. + schema: + type: string + default: ascending + enum: + - ascending + - descending + - name: limit + in: query + description: 'Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.' + schema: + type: integer + - name: users + in: query + description: Filters the returned results by user email. + schema: + type: array + items: + format: email + type: string + - name: statuses + in: query + description: Filters the returned results by the specified list of final statuses of the transactions. + schema: + type: array + items: + enum: + - SUCCESSFUL + - CANCELLED + - FAILED + - REFUNDED + - CHARGE_BACK + type: string + - name: payment_types + in: query + description: Filters the returned results by the specified list of payment types used for the transactions. + schema: + type: array + items: + enum: + - CASH + - POS + - ECOM + - BALANCE + - MOTO + - BOLETO + - UNKNOWN + type: string + - name: types + in: query + description: Filters the returned results by the specified list of transaction types. + schema: + type: array + items: + enum: + - PAYMENT + - REFUND + - CHARGE_BACK + type: string + - name: changes_since + in: query + description: 'Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: newest_time + in: query + description: 'Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: newest_ref + in: query + description: Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request). + schema: + type: string + - name: oldest_time + in: query + description: 'Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: oldest_ref + in: query + description: Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request). + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + items: + type: array + items: + $ref: '#/components/schemas/TransactionHistory' + links: + type: array + items: + $ref: '#/components/schemas/Link' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + deprecated: true + tags: + - Transactions + x-codegen: + method_name: list_deprecated + x-scopes: + - transactions.history + '/v0.1/merchants/{merchant_code}/api-keys': + get: + operationId: ListAPIKeys + summary: List API keys + description: | + Returns paginated list of API keys. + parameters: + - name: offset + in: query + description: Offset of the first key to return. + schema: + type: integer + example: 0 + default: 0 + minimum: 0 + - name: limit + in: query + description: Maximum number of keys to return. + schema: + type: integer + example: 10 + default: 10 + maximum: 25 + minimum: 1 + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + responses: + '200': + description: List of API keys. + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeysList' + tags: + - API Keys + x-permissions: + - api_keys_list + x-scopes: + - api_keys + post: + operationId: CreateAPIKey + summary: Create an API key + description: | + Creates a new API key for the user. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + name: + type: string + example: New Key Name + maxLength: 255 + scopes: + $ref: '#/components/schemas/OAuth2Scopes' + required: + - name + - scopes + responses: + '201': + description: Created API key. + content: + application/json: + schema: + $ref: '#/components/schemas/APIKey' + tags: + - API Keys + x-permissions: + - api_keys_create + x-scopes: + - 'api_keys:write' + '/v0.1/merchants/{merchant_code}/api-keys/{key_id}': + delete: + operationId: RevokeAPIKey + summary: Revoke an API key + description: | + Revokes an API key. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: key_id + in: path + required: true + schema: + type: string + example: sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9 + responses: + '204': + description: Successful revocation. + tags: + - API Keys + x-permissions: + - api_keys_delete + x-scopes: + - 'api_keys:write' + get: + operationId: GetAPIKey + summary: Retrieve an API Key + description: | + Gets an API key. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: key_id + in: path + required: true + schema: + type: string + example: sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9 + responses: + '200': + description: API key. + content: + application/json: + schema: + $ref: '#/components/schemas/APIKey' + tags: + - API Keys + x-permissions: + - api_keys_view + x-scopes: + - api_keys + put: + operationId: UpdateAPIKey + summary: Update an API key + description: | + Updates an API key. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: key_id + in: path + required: true + schema: + type: string + example: sup_pk_1tpmgSzNUHMkxZD1Kz2hdQorZAav6AcZ9 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + name: + description: New name for the API key. + type: string + example: My API Key + maxLength: 255 + scopes: + $ref: '#/components/schemas/OAuth2Scopes' + required: + - name + - scopes + responses: + '204': + description: Successful update. + tags: + - API Keys + x-permissions: + - api_keys_update + x-scopes: + - 'api_keys:write' + '/v0.1/merchants/{merchant_code}/members': + get: + operationId: ListMerchantMembers + summary: List members + description: | + Lists merchant members with their roles and permissions. + parameters: + - name: offset + in: query + description: Offset of the first member to return. + schema: + type: integer + example: 0 + default: 0 + minimum: 0 + - name: limit + in: query + description: Maximum number of member to return. + schema: + type: integer + example: 10 + default: 10 + maximum: 25 + minimum: 1 + - name: scroll + in: query + description: Indicates to skip count query. + schema: + type: boolean + example: true + default: false + - name: email + in: query + description: Filter the returned users by email address prefix. + schema: + type: string + example: user + - name: status + in: query + description: Filter the returned members by the membership status. + schema: + $ref: '#/components/schemas/MembershipStatus' + - name: roles + in: query + description: Filter the returned users by role. + schema: + type: array + items: + type: string + example: + - role_employee + - role_accountant + explode: true + style: form + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + responses: + '200': + description: List of members. + content: + application/json: + schema: + type: object + properties: + items: + type: array + items: + $ref: '#/components/schemas/Member' + total_count: + type: integer + example: 3 + required: + - items + '404': + description: Merchant not found. + tags: + - Members + x-scopes: [] + post: + operationId: AddMerchantMember + summary: Add member to merchant. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + attributes: + $ref: '#/components/schemas/Attributes' + email: + description: Email address of the member to add. + type: string + format: email + is_managed_user: + description: | + True if the user is managed by the merchant. In this case, we'll created a virtual user with the provided password and nickname. + type: boolean + metadata: + $ref: '#/components/schemas/Metadata' + nickname: + description: | + Nickname of the member to add. Only used if `is_managed_user` is true. Used for display purposes only. + type: string + example: Test User + password: + description: Password of the member to add. Only used if `is_managed_user` is true. + type: string + format: password + minLength: 8 + roles: + description: List of roles to assign to the new member. + type: array + items: + type: string + required: + - email + - roles + responses: + '201': + description: Member created. + content: + application/json: + schema: + $ref: '#/components/schemas/Member' + '400': + description: Invalid request. + '404': + description: Merchant not found. + '429': + description: | + Too many invitations sent to that user. The limit is 10 requests per 5 minutes and the Retry-After header is set to the number of minutes until the reset of the limit. + tags: + - Members + x-permissions: + - members_create + x-scopes: [] + '/v0.1/merchants/{merchant_code}/members/{member_id}': + delete: + operationId: DeleteMerchantMember + summary: Delete member + description: Deletes member by ID. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: member_id + in: path + required: true + schema: + type: string + example: mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP + responses: + '200': + description: Member deleted. + '404': + description: Merchant or member not found. + tags: + - Members + x-permissions: + - members_delete + x-scopes: [] + get: + operationId: GetMerchantMember + summary: Get merchant member + description: Returns merchant member details. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: member_id + in: path + required: true + schema: + type: string + example: mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP + responses: + '200': + description: Merchant member. + content: + application/json: + schema: + $ref: '#/components/schemas/Member' + '404': + description: Merchant or member not found. + tags: + - Members + x-permissions: + - members_view + x-scopes: [] + put: + operationId: UpdateMerchantMember + summary: Update merchant member + description: Update assigned roles of the member. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: member_id + in: path + required: true + schema: + type: string + example: mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + attributes: + $ref: '#/components/schemas/Attributes' + metadata: + $ref: '#/components/schemas/Metadata' + roles: + type: array + items: + type: string + user: + description: Allows you to update user data of managed users. + type: object + properties: + nickname: + description: | + User's preferred name. Used for display purposes only. + type: string + example: Test User + password: + description: Password of the member to add. Only used if `is_managed_user` is true. + type: string + format: password + minLength: 8 + responses: + '200': + description: Member updated. + content: + application/json: + schema: + $ref: '#/components/schemas/Member' + '400': + description: Cannot set password or nickname for an invited user. + '403': + description: Cannot change password for managed user. Password was already used before. + '404': + description: Merchant or member not found. + '409': + description: Cannot update member as some data conflict with existing members. + tags: + - Members + x-permissions: + - members_update + x-scopes: [] + '/v0.1/merchants/{merchant_code}/payment-methods': + get: + operationId: GetPaymentMethods + summary: Get available payment methods + description: Get payment methods available for the given merchant to use with a checkout. + parameters: + - name: merchant_code + in: path + description: The SumUp merchant code. + required: true + schema: + type: string + example: M1234 + - name: amount + in: query + description: 'The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.' + schema: + type: number + example: 9.99 + - name: currency + in: query + description: The currency for which the payment methods should be eligible. + schema: + type: string + example: EUR + responses: + '200': + description: Available payment methods + content: + application/json: + examples: + success: + description: Available payment methods + value: + available_payment_methods: + - id: apple_pay + - id: blik + schema: + type: object + properties: + available_payment_methods: + type: array + items: + properties: + id: + description: The ID of the payment method. + type: string + example: qr_code_pix + required: + - id + type: object + '400': + description: Bad Request + content: + application/json: + examples: + Invalid_Parameter: + description: One or more of the parameters are invalid. + value: + failed_constraints: + - message: Currency must also be specified when filtering by amount + reference: currency + status: 400 + title: Bad Request + schema: + $ref: '#/components/schemas/DetailsError' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Checkouts + x-codegen: + method_name: list_available_payment_methods + x-scopes: + - payments + '/v0.1/merchants/{merchant_code}/readers': + get: + operationId: ListReaders + summary: List Readers + description: | + Returns list of all readers of the merchant. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + responses: + '200': + description: | + List of readers + content: + application/json: + schema: + type: object + properties: + items: + type: array + items: + $ref: '#/components/schemas/Reader' + required: + - items + tags: + - Readers + x-permissions: + - readers_list + x-scopes: + - readers.read + post: + operationId: CreateReader + summary: Create a Reader + description: | + Create a new reader linked to the merchant account. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + meta: + $ref: '#/components/schemas/Meta' + name: + $ref: '#/components/schemas/ReaderName' + pairing_code: + $ref: '#/components/schemas/ReaderPairingCode' + required: + - pairing_code + responses: + '201': + description: | + The reader got created. + content: + application/json: + examples: + created: + $ref: '#/components/examples/CreatedReader' + schema: + $ref: '#/components/schemas/Reader' + links: + DeleteReaderByID: + $ref: '#/components/links/DeleteReaderByID' + UpdateReaderByID: + $ref: '#/components/links/UpdateReaderByID' + tags: + - Readers + x-permissions: + - readers_create + x-scopes: + - readers.write + '/v0.1/merchants/{merchant_code}/readers/{id}': + delete: + operationId: DeleteReader + summary: Delete a reader + description: | + Deletes a Reader. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: path + description: | + The unique identifier of the reader. + required: true + schema: + $ref: '#/components/schemas/ReaderID' + responses: + '200': + description: | + The reader got successfully deleted from the merchant account. + tags: + - Readers + x-permissions: + - readers_delete + x-scopes: + - readers.write + get: + operationId: GetReader + summary: Retrieve a Reader + description: | + Gets a Reader. + parameters: + - name: If-Modified-Since + in: header + description: | + Return the reader only if it has been modified after the specified timestamp given in the headers. + + Timestamps are accepted in the following formats: + - HTTP Standard: [IMF format (RFC 5322)](https://www.rfc-editor.org/rfc/rfc5322#section-3.3), sometimes also referred to as [RFC 7231](https://www.rfc-editor.org/rfc/rfc7231#section-7.1.1.1). + - RFC 3339: Used for timestamps in JSON payloads on this API. + schema: + type: string + oneOf: + - example: 'Tue, 03 May 2022 14:46:44 GMT' + format: httpdate + type: string + - example: '2023-05-30T10:38:01+00:00' + format: date-time + type: string + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: path + description: | + The unique identifier of the reader. + required: true + schema: + $ref: '#/components/schemas/ReaderID' + responses: + '200': + description: | + Reader object got returned. + content: + application/json: + schema: + $ref: '#/components/schemas/Reader' + '400': + description: Malformed request. + '404': + description: | + The requested Reader resource does not exists. + tags: + - Readers + x-permissions: + - readers_view + x-scopes: + - readers.read + patch: + operationId: UpdateReader + summary: Update a Reader + description: | + Updates a Reader. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: path + description: | + The unique identifier of the reader. + required: true + schema: + $ref: '#/components/schemas/ReaderID' + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + meta: + $ref: '#/components/schemas/Meta' + name: + $ref: '#/components/schemas/ReaderName' + responses: + '304': + description: | + The update request was successful, but the reader didn't get updated. + '403': + description: | + The reader is not linked to the merchant account. + tags: + - Readers + x-permissions: + - readers_update + x-scopes: + - readers.write + '/v0.1/merchants/{merchant_code}/readers/{id}/checkout': + post: + operationId: CreateReaderCheckout + summary: Create a Reader Checkout + description: | + Create a Checkout for a Reader. + + This process is asynchronous and the actual transaction may take some time to be stared on the device. + + + There are some caveats when using this endpoint: + * The target device must be online, otherwise checkout won't be accepted + * After the checkout is accepted, the system has 60 seconds to start the payment on the target device. During this time, any other checkout for the same device will be rejected. + + **Note**: If the target device is a Solo, it must be in version 3.3.24.3 or higher. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: path + description: | + The unique identifier of the reader. + required: true + schema: + type: string + example: rdr_3MSAFM23CK82VSTT4BN6RWSQ65 + maxLength: 30 + minLength: 30 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateReaderCheckout' + responses: + '201': + description: | + The Checkout got successfully created for the given reader. + content: + application/json: + schema: + type: object + properties: + data: + type: object + properties: + client_transaction_id: + description: | + The client transaction ID is a unique identifier for the transaction that is generated for the client. + It can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get). + type: string + format: uuid + example: 123e4567-e89b-12d3-a456-426614174000 + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Bad Request + '422': + description: Unprocessable Entity + content: + application/json: + examples: + DataValidation: + description: Validation errors for the informed fields. + value: + errors: + card_type: + - is invalid + installments: + - not allowed + total_amount: + - is too low + - this merchant can only accept 'EUR' + ReaderCheckoutPending: + description: Error returned when a checkout was requested in the last 60 seconds. + value: + errors: + detail: A pending transaction already exists for this device + ReaderOffline: + description: Error returned when the target device is not online. + value: + errors: + detail: The device is offline. + type: READER_OFFLINE + schema: + type: object + properties: + errors: + type: object + additionalProperties: true + '500': + description: Internal Server Error + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Internal Server Error + '502': + description: Bad Gateway + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Bad Gateway + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Gateway Timeout + callbacks: + ReaderCheckoutStatusChange: + '{$request.body#/return_url}': + post: + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ReaderCheckoutStatusChange' + responses: + '200': + description: | + Your server returns this code if it accepts the callback. + If the server returns any other code, the callback will be retried up to 5 times with exponential backoff. + tags: + - Readers + x-permissions: + - readers_checkout_create + x-scopes: + - readers.write + '/v0.1/merchants/{merchant_code}/readers/{id}/terminate': + post: + operationId: CreateReaderTerminate + summary: Create a Reader Terminate action + description: | + Create a Terminate action for a Reader. + + It stops the current transaction on the target device. + + This process is asynchronous and the actual termination may take some time to be performed on the device. + + + There are some caveats when using this endpoint: + * The target device must be online, otherwise terminate won't be accepted + * The action will succeed only if the device is waiting for cardholder action: e.g: waiting for card, waiting for PIN, etc. + * There is no confirmation of the termination. + + If a transaction is successfully terminated and `return_url` was provided on Checkout, the transaction status will be sent as `failed` to the provided URL. + + **Note**: If the target device is a Solo, it must be in version 3.3.28.0 or higher. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: path + description: | + The unique identifier of the reader. + required: true + schema: + type: string + example: rdr_3MSAFM23CK82VSTT4BN6RWSQ65 + maxLength: 30 + minLength: 30 + responses: + '202': + description: | + The Terminate action was successfully dispatched for the given reader. + '422': + description: Unprocessable Entity + content: + application/json: + examples: + ReaderOffline: + description: Error returned when the target device is not online. + value: + errors: + detail: The device is offline. + type: READER_OFFLINE + schema: + type: object + properties: + errors: + type: object + additionalProperties: true + '500': + description: Internal Server Error + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Internal Server Error + '502': + description: Bad Gateway + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Bad Gateway + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + errors: + type: object + properties: + detail: + type: string + example: Gateway Timeout + tags: + - Readers + x-permissions: + - readers_checkout_create + x-scopes: + - readers.write + '/v1.1/merchants/{merchant_code}/bank-accounts': + get: + operationId: ListBankAccountsV11 + summary: List bank accounts + description: Retrieves bank accounts of the merchant. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: primary + in: query + description: If true only the primary bank account (the one used for payouts) will be returned. + schema: + type: boolean + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/BankAccount' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '403': + description: Forbidden + content: + application/json: + examples: + Forbidden: + description: You do not have required scopes for making this request. + value: + error_code: FORBIDDEN + error_message: request_not_allowed + status_code: '403' + schema: + $ref: '#/components/schemas/ErrorForbidden' + tags: + - Merchant + x-codegen: + method_name: list_bank_accounts + x-scopes: + - user.payout-settings + - user.profile + - user.profile_readonly + '/v1.1/receipts/{id}': + get: + operationId: GetReceipt + summary: Retrieve receipt details + description: Retrieves receipt specific data for a transaction. + parameters: + - name: id + in: path + description: 'SumUp unique transaction ID or transaction code, e.g. TS7HDYLSKD.' + required: true + schema: + type: string + - name: mid + in: query + description: Merchant code. + required: true + schema: + type: string + - name: tx_event_id + in: query + description: The ID of the transaction event (refund). + schema: + type: integer + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/Receipt' + '400': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Receipts + x-codegen: + method_name: get + x-scopes: [] + '/v2.1/merchants/{merchant_code}/transactions': + get: + operationId: GetTransactionV2.1 + summary: Retrieve a transaction + description: | + Retrieves the full details of an identified transaction. The transaction resource is identified by a query parameter and *one* of following parameters is required: + * `id` + * `internal_id` + * `transaction_code` + * `foreign_transaction_id` + * `client_transaction_id` + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: id + in: query + description: Retrieves the transaction resource with the specified transaction ID (the `id` parameter in the transaction resource). + schema: + type: string + - name: internal_id + in: query + description: Retrieves the transaction resource with the specified internal transaction ID (the `internal_id` parameter in the transaction resource). + schema: + type: string + - name: transaction_code + in: query + description: Retrieves the transaction resource with the specified transaction code. + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/TransactionFull' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + '404': + description: Not Found + content: + application/json: + examples: + Not_Found: + description: The identified resource is not found on the server. + value: + error_code: NOT_FOUND + message: Resource not found + schema: + $ref: '#/components/schemas/Error' + tags: + - Transactions + x-codegen: + method_name: get + x-scopes: + - transactions.history + '/v2.1/merchants/{merchant_code}/transactions/history': + get: + operationId: ListTransactionsV2.1 + summary: List transactions + description: Lists detailed history of all transactions associated with the merchant profile. + parameters: + - name: merchant_code + in: path + required: true + schema: + type: string + example: MC0X0ABC + - name: transaction_code + in: query + description: Retrieves the transaction resource with the specified transaction code. + schema: + type: string + - name: order + in: query + description: Specifies the order in which the returned results are displayed. + schema: + type: string + default: ascending + enum: + - ascending + - descending + - name: limit + in: query + description: 'Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.' + schema: + type: integer + - name: users + in: query + description: Filters the returned results by user email. + schema: + type: array + items: + format: email + type: string + - name: statuses + in: query + description: Filters the returned results by the specified list of final statuses of the transactions. + schema: + type: array + items: + enum: + - SUCCESSFUL + - CANCELLED + - FAILED + - REFUNDED + - CHARGE_BACK + type: string + - name: payment_types + in: query + description: Filters the returned results by the specified list of payment types used for the transactions. + schema: + type: array + items: + enum: + - CASH + - POS + - ECOM + - BALANCE + - MOTO + - BOLETO + - UNKNOWN + type: string + - name: types + in: query + description: Filters the returned results by the specified list of transaction types. + schema: + type: array + items: + enum: + - PAYMENT + - REFUND + - CHARGE_BACK + type: string + - name: changes_since + in: query + description: 'Filters the results by the latest modification time of resources and returns only transactions that are modified *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: newest_time + in: query + description: 'Filters the results by the creation time of resources and returns only transactions that are created *before* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: newest_ref + in: query + description: Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *smaller* than the specified value. This parameters supersedes the `newest_time` parameter (if both are provided in the request). + schema: + type: string + - name: oldest_time + in: query + description: 'Filters the results by the creation time of resources and returns only transactions that are created *at or after* the specified timestamp (in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) format).' + schema: + type: string + format: date-time + - name: oldest_ref + in: query + description: Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are *greater* than the specified value. This parameters supersedes the `oldest_time` parameter (if both are provided in the request). + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + items: + type: array + items: + $ref: '#/components/schemas/TransactionHistory' + links: + type: array + items: + $ref: '#/components/schemas/Link' + '401': + description: Unauthorized + content: + application/json: + examples: + Invalid_Token: + description: The access token is invalid or has expired. + value: + error_code: NOT_AUTHORIZED + error_message: invalid access token + Missing_Token: + description: No access token is provided. + value: + error_code: NOT_AUTHORIZED + message: access token required + Not_Authorized_Token: + description: The access token is valid but the application is not authorized. + value: + error_code: NOT_AUTHORIZED + error_message: NOT_AUTHORIZED + schema: + $ref: '#/components/schemas/Error' + tags: + - Transactions + x-codegen: + method_name: list + x-scopes: + - transactions.history +components: + schemas: + APIKey: + type: object + properties: + created_at: + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + id: + description: | + Unique identifier of the API Key. + type: string + example: sup_pk_0D1FIpM6xqueY3L4Y994nseK0xMfOjPAU + name: + description: User-assigned name of the API Key. + type: string + example: My API Key + plaintext: + description: | + The plaintext value of the API key. This field is returned only in the response to API key creation and is never again available in the plaintext form. + type: string + example: sup_sk_LZFWoLydp6S4S4KQpGVs1POzzp6cL1vyZ + preview: + description: | + Last 8 characters of the API key. + type: string + example: p6cL1vyZ + scopes: + $ref: '#/components/schemas/OAuth2Scopes' + type: + type: string + example: secret + enum: + - public + - secret + updated_at: + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + required: + - id + - name + - scopes + - preview + - type + - created_at + - updated_at + title: API Key + APIKeysList: + type: object + properties: + items: + type: array + items: + $ref: '#/components/schemas/APIKey' + total_count: + type: integer + example: + items: + - created_at: '2023-03-24T10:10:10Z' + id: sup_pk_1tpmgizNLHMkx1DdKd2hdzorZAaf6AcZ9 + name: '' + preview: Aaf6AcZ9 + scopes: [] + type: public + updated_at: '2023-03-24T10:10:10Z' + - created_at: '2023-03-25T09:10:10Z' + id: sup_pk_0D1FIpM6xqueY3L4Y994nseK0xMfOjPAU + name: Test Key + preview: TGhqew1b + scopes: + - transactions.history + - user.app-settings + - user.profile_readonly + - user.profile + - user.subaccounts + - user.payout-settings + - products + - payments + - payment_instruments + - readers.read + - readers.write + type: secret + updated_at: '2023-03-25T09:10:10Z' + total_count: 2 + required: + - items + - total_count + Account: + description: Profile information. + type: object + properties: + type: + description: The role of the user. + type: string + enum: + - normal + - operator + username: + description: Username of the user profile. + type: string + Address: + description: Profile's personal address information. + type: object + properties: + city: + description: City name from the address. + type: string + example: Berlin + country: + description: 'Two letter country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).' + type: string + example: DE + line1: + description: First line of the address with details of the street name and number. + type: string + example: Sample street + line2: + description: 'Second line of the address with details of the building, unit, apartment, and floor numbers.' + type: string + example: ap. 5 + postal_code: + description: Postal code from the address. + type: string + example: '10115' + state: + description: State name or abbreviation from the address. + type: string + example: Berlin + required: + - country + AddressWithDetails: + description: Details of the registered address. + type: object + properties: + address_line1: + description: Address line 1 + type: string + address_line2: + description: Address line 2 + type: string + city: + description: City + type: string + company: + description: undefined + type: string + country: + description: Country ISO 3166-1 code + type: string + country_details: + $ref: '#/components/schemas/CountryDetails' + first_name: + description: undefined + type: string + landline: + description: Landline number + type: string + last_name: + description: undefined + type: string + post_code: + description: Postal code + type: string + region_code: + description: Region code + type: string + region_id: + description: Country region id + type: number + region_name: + description: Region name + type: string + state_id: + description: undefined + type: string + timeoffset_details: + $ref: '#/components/schemas/TimeoffsetDetails' + Affiliate: + description: | + Affiliate metadata for the transaction. + It is an optional field that allow for integrators to track the source of the transaction. + type: object + properties: + app_id: + description: | + Application ID of the affiliate. + It is a unique identifier for the application and should be set by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page. + type: string + example: com.example.app + foreign_transaction_id: + description: | + Foreign transaction ID of the affiliate. + It is a unique identifier for the transaction. + It can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get). + type: string + example: '123456' + key: + description: | + Key of the affiliate. + It is a unique identifier for the key and should be generated by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page. + type: string + format: uuid + example: 123e4567-e89b-12d3-a456-426614174000 + tags: + description: | + Additional metadata for the transaction. + It is key-value object that can be associated with the transaction. + type: object + example: {} + additionalProperties: true + required: + - app_id + - key + - foreign_transaction_id + AmountEvent: + description: Amount of the event. + type: number + format: float + AppSettings: + description: Mobile app settings + type: object + properties: + advanced_mode: + description: Advanced mode. + type: string + barcode_scanner: + description: Barcode scanner. + type: string + cash_payment: + description: Cash payment. + type: string + checkout_preference: + description: Checkout preference + type: string + expected_max_transaction_amount: + description: Expected max transaction amount. + type: number + include_vat: + description: Include vat. + type: boolean + manual_entry: + description: Manual entry. + type: string + manual_entry_tutorial: + description: Manual entry tutorial. + type: boolean + mobile_payment: + description: Mobile payment. + type: string + mobile_payment_tutorial: + description: Mobile payment tutorial. + type: boolean + reader_payment: + description: Reader payment. + type: string + referral: + description: Referral. + type: string + tax_enabled: + description: Tax enabled. + type: boolean + terminal_mode_tutorial: + description: Terminal mode tutorial. + type: boolean + tip_rates: + description: Tip rates. + type: array + items: + format: float + type: number + tipping: + description: Tipping. + type: string + Attributes: + description: Object attributes that modifiable only by SumUp applications. + type: object + example: {} + additionalProperties: + maxLength: 256 + AuthToken: + description: Authorization token flow + type: object + properties: + client_id: + description: 'The client ID of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app).' + type: string + example: fOcmczrYtYMJ7Li5GjMLLcUeC9dN + client_secret: + description: 'The client secret of your application that was generated when you [registered it](https://developer.sumup.com/docs/register-app).' + type: string + example: 717bd571b54297494cd7a79b491e8f2c1da6189c4cc2d3481380e8366eef539c + code: + description: The authorization code that you received from requesting an authorization code. + type: string + example: be366ce9fccd0c337d1da29b31d06dd1135ab95401562883 + grant_type: + description: The grant type used for obtaining an access token. + type: string + example: refresh_token + enum: + - authorization_code + - refresh_token + refresh_token: + description: A **required** parameter when generating a refresh token. + type: string + example: d180031bfe9bac36c336e5746637810272546865e9c9586012f462a56f3fe9af + required: + - grant_type + - client_id + - client_secret + - code + BankAccount: + type: object + properties: + account_category: + description: Account category - business or personal + type: string + account_holder_name: + type: string + account_number: + description: Account number + type: string + account_type: + description: Type of the account + type: string + bank_code: + description: Bank code + type: string + bank_name: + description: Bank name + type: string + branch_code: + description: Branch code + type: string + created_at: + description: Creation date of the bank account + type: string + iban: + description: IBAN + type: string + primary: + description: The primary bank account is the one used for payouts + type: boolean + status: + description: Status in the verification process + type: string + swift: + description: SWIFT code + type: string + BusinessOwners: + description: Business owners information. + type: array + items: + properties: + date_of_birth: + description: Date of birth + type: string + first_name: + description: BO's first name + type: string + landline: + description: BO's Landline + type: string + last_name: + description: BO's last name of the user + type: string + mobile_phone: + description: Mobile phone number + type: string + ownership: + description: Ownership percentage + type: number + type: object + Card: + description: __Required when payment type is `card`.__ Details of the payment card. + type: object + properties: + cvv: + description: Three or four-digit card verification value (security code) of the payment card. + type: string + example: '123' + maxLength: 4 + minLength: 3 + writeOnly: true + expiry_month: + description: Month from the expiration time of the payment card. Accepted format is `MM`. + type: string + enum: + - '01' + - '02' + - '03' + - '04' + - '05' + - '06' + - '07' + - '08' + - '09' + - '10' + - '11' + - '12' + writeOnly: true + expiry_year: + description: Year from the expiration time of the payment card. Accepted formats are `YY` and `YYYY`. + type: string + example: '2023' + maxLength: 4 + minLength: 2 + writeOnly: true + last_4_digits: + description: Last 4 digits of the payment card number. + type: string + example: '3456' + maxLength: 4 + minLength: 4 + readOnly: true + name: + description: Name of the cardholder as it appears on the payment card. + type: string + example: FIRSTNAME LASTNAME + writeOnly: true + number: + description: Number of the payment card (without spaces). + type: string + example: '1234567890123456' + writeOnly: true + type: + description: Issuing card network of the payment card. + type: string + enum: + - AMEX + - CUP + - DINERS + - DISCOVER + - ELO + - ELV + - HIPERCARD + - JCB + - MAESTRO + - MASTERCARD + - VISA + - VISA_ELECTRON + - VISA_VPAY + - UNKNOWN + readOnly: true + zip_code: + description: Required five-digit ZIP code. Applicable only to merchant users in the USA. + type: string + example: '12345' + maxLength: 5 + minLength: 5 + writeOnly: true + required: + - name + - number + - expiry_month + - expiry_year + - cvv + - last_4_digits + - type + CardResponse: + description: Details of the payment card. + type: object + properties: + last_4_digits: + description: Last 4 digits of the payment card number. + type: string + example: '3456' + maxLength: 4 + minLength: 4 + readOnly: true + type: + description: Issuing card network of the payment card. + type: string + enum: + - AMEX + - CUP + - DINERS + - DISCOVER + - ELO + - ELV + - HIPERCARD + - JCB + - MAESTRO + - MASTERCARD + - VISA + - VISA_ELECTRON + - VISA_VPAY + - UNKNOWN + readOnly: true + Checkout: + description: Details of the payment checkout. + type: object + properties: + amount: + description: Amount of the payment. + type: number + format: float + example: 10.1 + checkout_reference: + description: Unique ID of the payment checkout specified by the client application when creating the checkout resource. + type: string + maxLength: 90 + currency: + $ref: '#/components/schemas/Currency' + customer_id: + description: 'Unique identification of a customer. If specified, the checkout session and payment instrument are associated with the referenced customer.' + type: string + example: 831ff8d4cd5958ab5670 + date: + description: 'Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + description: + description: 'Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.' + type: string + id: + description: Unique ID of the checkout resource. + type: string + example: 4e425463-3e1b-431d-83fa-1e51c2925e99 + readOnly: true + mandate: + $ref: '#/components/schemas/MandateResponse' + merchant_code: + description: Unique identifying code of the merchant profile. + type: string + pay_to_email: + description: Email address of the registered user (merchant) to whom the payment is made. + type: string + format: email + return_url: + description: URL to which the SumUp platform sends the processing status of the payment checkout. + type: string + format: uri + status: + description: Current status of the checkout. + type: string + enum: + - PENDING + - FAILED + - PAID + transactions: + description: List of transactions related to the payment. + type: array + items: + allOf: + - $ref: '#/components/schemas/TransactionMixinBase' + - $ref: '#/components/schemas/TransactionMixinCheckout' + uniqueItems: true + valid_until: + description: 'Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + nullable: true + title: Checkout + CheckoutCreateRequest: + description: Details of the payment checkout. + type: object + properties: + amount: + description: Amount of the payment. + type: number + format: float + checkout_reference: + description: Unique ID of the payment checkout specified by the client application when creating the checkout resource. + type: string + maxLength: 90 + currency: + $ref: '#/components/schemas/Currency' + customer_id: + description: 'Unique identification of a customer. If specified, the checkout session and payment instrument are associated with the referenced customer.' + type: string + date: + description: 'Date and time of the creation of the payment checkout. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + readOnly: true + description: + description: 'Short description of the checkout visible in the SumUp dashboard. The description can contribute to reporting, allowing easier identification of a checkout.' + type: string + id: + description: Unique ID of the checkout resource. + type: string + readOnly: true + merchant_code: + description: Unique identifying code of the merchant profile. + type: string + pay_to_email: + description: Email address of the registered user (merchant) to whom the payment is made. It is highly recommended to use `merchant_code` instead of `pay_to_email`. + type: string + format: email + payment_type: + description: Alternative payment method name + type: string + example: boleto + personal_details: + description: 'Object containing personal details about the payer, typical for __Boleto__ checkouts' + type: object + properties: + address: + description: Payer's address information + type: object + properties: + city: + description: Payer's city + type: string + example: Rio de Janeiro + country: + description: Payer's country + type: string + example: BR + line_1: + description: Field for address details + type: string + postal_code: + description: 'Payer''s postal code. Must be eight digits long, however an optional dash could be applied after the 5th digit ([more information about the format available here](https://en.wikipedia.org/wiki/List_of_postal_codes_in_Brazil)). Both options are accepted as correct.' + type: string + example: 20000-000 + pattern: '^\d{5}-?\d{3}$' + state: + description: Payer's state code + type: string + example: RJ + enum: + - AC + - AL + - AP + - AM + - BA + - CE + - DF + - ES + - GO + - MA + - MT + - MS + - MG + - PA + - PB + - PR + - PE + - PI + - RJ + - RN + - RS + - RO + - RR + - SC + - SP + - SE + - TO + email: + description: Payer's email address + type: string + example: test@example.com + first_name: + description: Payer's first name + type: string + example: John + last_name: + description: Payer's last name + type: string + example: Doe + tax_id: + description: Payer's tax identification number (CPF) + type: string + example: 423.378.593-47 + purpose: + description: Purpose of the checkout. + type: string + default: CHECKOUT + enum: + - CHECKOUT + - SETUP_RECURRING_PAYMENT + redirect_url: + description: '__Required__ for [APMs](https://developer.sumup.com/online-payments/apm/introduction) and __recommended__ for card payments. Refers to a url where the end user is redirected once the payment processing completes. If not specified, the [Payment Widget](https://developer.sumup.com/online-payments/tools/card-widget) renders [3DS challenge](https://developer.sumup.com/online-payments/features/3ds) within an iframe instead of performing a full-page redirect.' + type: string + example: 'https://mysite.com/completed_purchase' + return_url: + description: URL to which the SumUp platform sends the processing status of the payment checkout. + type: string + format: uri + status: + description: Current status of the checkout. + type: string + enum: + - PENDING + - FAILED + - PAID + readOnly: true + transactions: + description: List of transactions related to the payment. + type: array + items: + allOf: + - $ref: '#/components/schemas/TransactionMixinBase' + - $ref: '#/components/schemas/TransactionMixinCheckout' + readOnly: true + uniqueItems: true + valid_until: + description: 'Date and time of the checkout expiration before which the client application needs to send a processing request. If no value is present, the checkout does not have an expiration time.' + type: string + format: date-time + example: '2020-02-29T10:56:56+00:00' + nullable: true + readOnly: true + required: + - checkout_reference + - amount + - currency + - merchant_code + CheckoutProcessMixin: + description: Details of the payment instrument for processing the checkout. + type: object + properties: + card: + $ref: '#/components/schemas/Card' + customer_id: + description: __Required when `token` is provided.__ Unique ID of the customer. + type: string + installments: + description: Number of installments for deferred payments. Available only to merchant users in Brazil. + type: integer + maximum: 12 + minimum: 1 + mandate: + $ref: '#/components/schemas/MandatePayload' + payment_type: + type: string + enum: + - card + - boleto + - ideal + - blik + - bancontact + token: + description: __Required when using a tokenized card to process a checkout.__ Unique token identifying the saved payment card for a customer. + type: string + required: + - payment_type + CheckoutSuccess: + allOf: + - $ref: '#/components/schemas/Checkout' + - properties: + merchant_name: + description: Name of the merchant + type: string + example: Sample Merchant + payment_instrument: + description: Object containing token information for the specified payment instrument + type: object + properties: + token: + description: Token value + type: string + example: e76d7e5c-9375-4fac-a7e7-b19dc5302fbc + redirect_url: + description: Refers to a url where the end user is redirected once the payment processing completes. + type: string + example: 'https://mysite.com/completed_purchase' + transaction_code: + description: Transaction code of the successful transaction with which the payment for the checkout is completed. + type: string + example: TEENSK4W2K + readOnly: true + transaction_id: + description: Transaction ID of the successful transaction with which the payment for the checkout is completed. + type: string + example: 410fc44a-5956-44e1-b5cc-19c6f8d727a4 + readOnly: true + type: object + CompatError: + description: Error + type: object + properties: + error_code: + type: string + example: NOT_FOUND + message: + type: string + example: Resource not found. + required: + - error_code + - message + CountryDetails: + description: Country Details + type: object + properties: + currency: + description: Currency ISO 4217 code + type: string + en_name: + description: Country EN name + type: string + iso_code: + description: Country ISO code + type: string + native_name: + description: Country native name + type: string + CreateReaderCheckout: + description: Reader Checkout + type: object + properties: + affiliate: + $ref: '#/components/schemas/Affiliate' + card_type: + description: | + The card type of the card used for the transaction. + Is is required only for some countries (e.g: Brazil). + type: string + example: credit + enum: + - credit + - debit + description: + description: | + Description of the checkout to be shown in the Merchant Sales + type: string + installments: + description: | + Number of installments for the transaction. + It may vary according to the merchant country. + For example, in Brazil, the maximum number of installments is 12. + type: integer + example: 1 + return_url: + description: | + Webhook URL to which the payment result will be sent. + It must be a HTTPS url. + type: string + format: uri + example: 'https://www.example.com' + tip_rates: + description: | + List of tipping rates to be displayed to the cardholder. + The rates are in percentage and should be between 0.01 and 0.99. + The list should be sorted in ascending order. + type: array + items: + format: float + multipleOf: 0.01 + type: number + total_amount: + $ref: '#/components/schemas/CreateReaderCheckoutAmount' + required: + - total_amount + title: Reader + CreateReaderCheckoutAmount: + description: | + Amount of the transaction. + The amount is represented as an integer value altogether with the currency and the minor unit. + For example, EUR 1.00 is represented as value 100 with minor unit of 2. + type: object + properties: + currency: + description: Currency ISO 4217 code + type: string + example: EUR + minor_unit: + description: | + The minor units of the currency. It represents the number of decimals of the currency. + For the currencies CLP, COP and HUF, the minor unit is 0. + type: integer + example: 2 + value: + description: | + Total amount of the transaction. + It must be a positive integer. + type: integer + example: 1000 + required: + - value + - currency + - minor_unit + Currency: + description: 'Three-letter [ISO4217](https://en.wikipedia.org/wiki/ISO_4217) code of the currency for the amount. Currently supported currency values are enumerated above.' + type: string + example: EUR + enum: + - BGN + - BRL + - CHF + - CLP + - CZK + - DKK + - EUR + - GBP + - HRK + - HUF + - NOK + - PLN + - RON + - SEK + - USD + Customer: + type: object + properties: + customer_id: + description: Unique ID of the customer. + type: string + example: 831ff8d4cd5958ab5670 + personal_details: + $ref: '#/components/schemas/PersonalDetails' + required: + - customer_id + title: Customer + DetailsError: + description: Error message structure. + type: object + properties: + details: + description: Details of the error. + type: string + failed_constraints: + type: array + items: + properties: + message: + type: string + reference: + type: string + type: object + status: + description: The status code. + type: number + title: + description: Short title of the error. + type: string + DoingBusinessAs: + description: Doing Business As information + type: object + properties: + address: + type: object + properties: + address_line1: + description: Address line 1 + type: string + address_line2: + description: Address line 2 + type: string + city: + description: City + type: string + country: + description: Country ISO 3166-1 code + type: string + post_code: + description: Postal code + type: string + region_id: + description: Country region ID + type: number + region_name: + description: Country region name + type: string + business_name: + description: Doing business as name + type: string + company_registration_number: + description: Doing business as company registration number + type: string + email: + description: Doing business as email + type: string + vat_id: + description: Doing business as VAT ID + type: string + website: + description: Doing business as website + type: string + Error: + description: Error message structure. + type: object + properties: + error_code: + description: Platform code for the error. + type: string + message: + description: Short description of the error. + type: string + ErrorExtended: + allOf: + - $ref: '#/components/schemas/Error' + - properties: + param: + description: 'Parameter name (with relative location) to which the error applies. Parameters from embedded resources are displayed using dot notation. For example, `card.name` refers to the `name` parameter embedded in the `card` object.' + type: string + type: object + ErrorForbidden: + description: Error message for forbidden requests. + type: object + properties: + error_code: + description: Platform code for the error. + type: string + error_message: + description: Short description of the error. + type: string + status_code: + description: HTTP status code for the error. + type: string + Event: + type: object + properties: + amount: + $ref: '#/components/schemas/AmountEvent' + deducted_amount: + description: Amount deducted for the event. + type: number + format: float + deducted_fee_amount: + description: Amount of the fee deducted for the event. + type: number + format: float + fee_amount: + description: Amount of the fee related to the event. + type: number + format: float + id: + $ref: '#/components/schemas/EventID' + installment_number: + description: Consecutive number of the installment. + type: integer + status: + $ref: '#/components/schemas/EventStatus' + timestamp: + $ref: '#/components/schemas/TimestampEvent' + transaction_id: + $ref: '#/components/schemas/TransactionID' + type: + $ref: '#/components/schemas/EventType' + EventID: + description: Unique ID of the transaction event. + type: integer + format: int64 + EventStatus: + description: Status of the transaction event. + type: string + enum: + - PENDING + - SCHEDULED + - FAILED + - REFUNDED + - SUCCESSFUL + - PAID_OUT + EventType: + description: Type of the transaction event. + type: string + enum: + - PAYOUT + - CHARGE_BACK + - REFUND + - PAYOUT_DEDUCTION + FinancialPayouts: + type: array + items: + properties: + amount: + type: number + format: float + currency: + type: string + date: + type: string + format: date + fee: + type: number + format: float + id: + type: integer + reference: + type: string + status: + type: string + enum: + - SUCCESSFUL + - FAILED + transaction_code: + type: string + type: + type: string + enum: + - PAYOUT + - CHARGE_BACK_DEDUCTION + - REFUND_DEDUCTION + - DD_RETURN_DEDUCTION + - BALANCE_DEDUCTION + type: object + title: Financial Payouts + HorizontalAccuracy: + description: Indication of the precision of the geographical position received from the payment terminal. + type: number + format: float + Invite: + description: | + Pending invitation for membership. + type: object + properties: + email: + description: Email address of the invited user. + type: string + format: email + example: boaty.mcboatface@sumup.com + expires_at: + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + required: + - email + - expires_at + title: Invite + Lat: + description: Latitude value from the coordinates of the payment location (as received from the payment terminal reader). + type: number + format: float + maximum: 90 + minimum: 0 + LegalType: + description: Id of the legal type of the merchant profile + type: object + properties: + description: + description: Legal type short description + type: string + full_description: + description: Legal type description + type: string + id: + description: Unique id + type: number + sole_trader: + description: Sole trader legal type if true + type: boolean + Link: + description: Details of a link to a related resource. + type: object + properties: + href: + description: URL for accessing the related resource. + type: string + format: uri + rel: + description: Specifies the relation to the current resource. + type: string + type: + description: Specifies the media type of the related resource. + type: string + LinkRefund: + allOf: + - $ref: '#/components/schemas/Link' + - properties: + max_amount: + description: Maximum allowed amount for the refund. + type: number + format: float + min_amount: + description: Minimum allowed amount for the refund. + type: number + format: float + type: object + Lon: + description: Longitude value from the coordinates of the payment location (as received from the payment terminal reader). + type: number + format: float + maximum: 180 + minimum: 0 + MandatePayload: + description: Mandate is passed when a card is to be tokenized + type: object + properties: + type: + description: Indicates the mandate type + type: string + enum: + - recurrent + user_agent: + description: Operating system and web client used by the end-user + type: string + user_ip: + description: IP address of the end user. Supports IPv4 and IPv6 + type: string + example: + type: recurrent + user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36' + user_ip: 172.217.169.174 + required: + - type + - user_agent + MandateResponse: + description: Created mandate + type: object + properties: + merchant_code: + description: Merchant code which has the mandate + type: string + status: + description: Mandate status + type: string + type: + description: Indicates the mandate type + type: string + example: + merchant_code: MDASYTPD + status: active + type: recurrent + Member: + description: | + A member is user within specific resource identified by resource id, resource type, and associated roles. + type: object + properties: + attributes: + $ref: '#/components/schemas/Attributes' + created_at: + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + id: + description: ID of the member. + type: string + example: mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP + invite: + $ref: '#/components/schemas/Invite' + metadata: + $ref: '#/components/schemas/Metadata' + permissions: + description: User's permissions. + type: array + items: + type: string + example: + - members_read + - members_write + - create_moto_payments + - full_transaction_history_view + - refund_transactions + - create_referral + - developer_settings_edit + - developer_settings_access + roles: + description: User's roles. + type: array + items: + type: string + example: + - role_admin + status: + $ref: '#/components/schemas/MembershipStatus' + updated_at: + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + user: + $ref: '#/components/schemas/MembershipUser' + example: + created_at: '2023-01-20T15:16:17Z' + id: mem_WZsm7QTPhVrompscmPhoGTXXcrd58fr9MOhP + permissions: + - members_read + - members_write + - create_moto_payments + - full_transaction_history_view + - refund_transactions + - create_referral + - developer_settings_edit + - developer_settings_access + roles: + - role_admin + - role_owner + status: accepted + updated_at: '2023-02-20T15:16:17Z' + user: + email: example@sumup.com + id: 44ca0f5b-813b-46e1-aee7-e6242010662e + mfa_on_login_enabled: true + virtual_user: false + required: + - id + - roles + - permissions + - created_at + - updated_at + - status + title: Member + MembershipStatus: + type: string + enum: + - accepted + - pending + - expired + - disabled + - unknown + MembershipUser: + description: User information. + type: object + properties: + classic: + $ref: '#/components/schemas/MembershipUserClassic' + disabled_at: + description: | + Time when the user has been disabled. Applies only to virtual users (`virtual_user: true`). + type: string + format: date-time + email: + description: | + End-User's preferred e-mail address. Its value MUST conform to the RFC 5322 [RFC5322] addr-spec syntax. The RP MUST NOT rely upon this value being unique, for unique identification use ID instead. + type: string + example: example@sumup.com + id: + description: Identifier for the End-User (also called Subject). + type: string + example: 44ca0f5b-813b-46e1-aee7-e6242010662e + mfa_on_login_enabled: + description: | + True if the user has enabled MFA on login. + type: boolean + example: true + nickname: + description: | + User's preferred name. Used for display purposes only. + type: string + example: Test User + picture: + description: | + URL of the End-User's profile picture. This URL refers to an image file (for example, a PNG, JPEG, or GIF image file), rather than to a Web page containing an image. + type: string + format: uri + example: 'https://usercontent.sumup.com/44ca0f5b-813b-46e1-aee7-e6242010662e.png' + virtual_user: + description: | + True if the user is a virtual user (operator). + type: boolean + example: false + required: + - id + - email + - mfa_on_login_enabled + - virtual_user + MembershipUserClassic: + description: Classic identifiers of the user. + type: object + properties: + user_id: + type: integer + format: int32 + deprecated: true + required: + - user_id + MerchantAccount: + description: Details of the merchant account. + type: object + properties: + account: + $ref: '#/components/schemas/Account' + app_settings: + $ref: '#/components/schemas/AppSettings' + is_migrated_payleven_br: + description: Merchant comes from payleven BR migration + type: boolean + merchant_profile: + $ref: '#/components/schemas/MerchantProfile' + permissions: + $ref: '#/components/schemas/Permissions' + personal_profile: + $ref: '#/components/schemas/PersonalProfile' + title: Merchant Account + MerchantProfile: + description: Account's merchant profile + type: object + properties: + address: + $ref: '#/components/schemas/AddressWithDetails' + bank_accounts: + type: array + items: + $ref: '#/components/schemas/BankAccount' + business_owners: + $ref: '#/components/schemas/BusinessOwners' + company_name: + description: Company name + type: string + company_registration_number: + description: Company registration number + type: string + country: + description: 'Merchant country code formatted according to [ISO3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) (for internal usage only)' + type: string + doing_business_as: + $ref: '#/components/schemas/DoingBusinessAs' + extdev: + description: True if the merchant is extdev + type: boolean + legal_type: + $ref: '#/components/schemas/LegalType' + locale: + description: Merchant locale (for internal usage only) + type: string + merchant_category_code: + description: Merchant category code + type: string + merchant_code: + description: Unique identifying code of the merchant profile + type: string + mobile_phone: + description: Mobile phone number + type: string + nature_and_purpose: + description: Nature and purpose of the business + type: string + payout_zone_migrated: + description: True if the payout zone of this merchant is migrated + type: boolean + permanent_certificate_access_code: + description: Permanent certificate access code (Portugal) + type: string + settings: + $ref: '#/components/schemas/MerchantSettings' + vat_id: + description: Vat ID + type: string + vat_rates: + $ref: '#/components/schemas/VatRates' + website: + description: Website + type: string + MerchantSettings: + description: 'Merchant settings (like \"payout_type\", \"payout_period\")' + type: object + properties: + daily_payout_email: + description: Whether merchant will receive daily payout emails + type: boolean + gross_settlement: + description: Whether merchant has gross settlement enabled + type: boolean + monthly_payout_email: + description: Whether merchant will receive monthly payout emails + type: boolean + moto_payment: + description: Whether merchant can make MOTO payments + type: string + enum: + - UNAVAILABLE + - ENFORCED + - 'ON' + - 'OFF' + payout_instrument: + description: Payout Instrument + type: string + payout_on_demand: + description: Whether merchant will receive payouts on demand + type: boolean + payout_on_demand_available: + description: Whether merchant can edit payouts on demand + type: boolean + payout_period: + description: Payout frequency + type: string + payout_type: + description: Payout type + type: string + printers_enabled: + description: Whether to show printers in mobile app + type: boolean + stone_merchant_code: + description: Stone merchant code + type: string + tax_enabled: + description: Whether to show tax in receipts (saved per transaction) + type: boolean + Meta: + description: Set of user-defined key-value pairs attached to the object. + type: object + example: {} + additionalProperties: + maxLength: 256 + maxProperties: 50 + Metadata: + description: 'Set of user-defined key-value pairs attached to the object. Partial updates are not supported. When updating, always submit whole metadata.' + type: object + example: {} + additionalProperties: + maxLength: 256 + OAuth2Scopes: + type: array + items: + enum: + - accounting.read + - accounting.write + - email + - invoices.read + - invoices.write + - payment_instruments + - payments + - products + - profile + - readers.read + - readers.write + - transactions.history + - user.app-settings + - user.payout-settings + - user.profile + - user.profile_readonly + - user.subaccounts + type: string + example: + - invoices.read + - invoices.write + - products + - user.app-settings + maxItems: 128 + Operator: + type: object + properties: + account_type: + type: string + enum: + - operator + - normal + created_at: + type: string + format: date-time + disabled: + type: boolean + example: false + id: + type: integer + format: int32 + nickname: + type: string + example: Operator 1 + nullable: true + permissions: + $ref: '#/components/schemas/OperatorPermissions' + updated_at: + type: string + format: date-time + username: + type: string + example: operator1@mydomain.com + required: + - id + - username + - disabled + - created_at + - updated_at + - permissions + - account_type + OperatorPermissions: + type: object + properties: + admin: + type: boolean + create_moto_payments: + type: boolean + create_referral: + type: boolean + full_transaction_history_view: + type: boolean + refund_transactions: + type: boolean + required: + - create_moto_payments + - create_referral + - full_transaction_history_view + - refund_transactions + - admin + PaymentInstrumentResponse: + description: Payment Instrument Response + type: object + properties: + active: + description: 'Indicates whether the payment instrument is active and can be used for payments. To deactivate it, send a `DELETE` request to the resource endpoint.' + type: boolean + default: true + readOnly: true + card: + description: Details of the payment card. + type: object + properties: + last_4_digits: + description: Last 4 digits of the payment card number. + type: string + example: '3456' + maxLength: 4 + minLength: 4 + readOnly: true + type: + description: Issuing card network of the payment card. + type: string + enum: + - AMEX + - CUP + - DINERS + - DISCOVER + - ELO + - ELV + - HIPERCARD + - JCB + - MAESTRO + - MASTERCARD + - VISA + - VISA_ELECTRON + - VISA_VPAY + - UNKNOWN + readOnly: true + created_at: + description: 'Creation date of payment instrument. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.' + type: string + format: date-time + mandate: + $ref: '#/components/schemas/MandateResponse' + token: + description: Unique token identifying the saved payment card for a customer. + type: string + readOnly: true + type: + description: Type of the payment instrument. + type: string + enum: + - card + example: + active: true + card: + last_4_digits: '0001' + type: VISA + created_at: '2021-03-30T10:06:07.000+00:00' + mandate: + merchant_code: MDASYTPD + status: active + type: recurrent + token: bcfc8e5f-3b47-4cb9-854b-3b7a4cce7be3 + type: card + Permissions: + description: User permissions + type: object + properties: + create_moto_payments: + description: Create MOTO payments + type: boolean + create_referral: + description: Create referral + type: boolean + full_transaction_history_view: + description: Can view full merchant transaction history + type: boolean + refund_transactions: + description: Refund transactions + type: boolean + PersonalDetails: + description: Personal details for the customer. + type: object + properties: + address: + $ref: '#/components/schemas/Address' + birthdate: + description: Date of birth of the customer. + type: string + format: date + example: '1993-12-31' + email: + description: Email address of the customer. + type: string + example: user@example.com + first_name: + description: First name of the customer. + type: string + example: John + last_name: + description: Last name of the customer. + type: string + example: Doe + phone: + description: Phone number of the customer. + type: string + example: '+491635559723' + PersonalProfile: + description: Account's personal profile. + type: object + properties: + address: + $ref: '#/components/schemas/AddressWithDetails' + complete: + type: boolean + date_of_birth: + description: Date of birth + type: string + first_name: + description: First name of the user + type: string + last_name: + description: Last name of the user + type: string + mobile_phone: + description: Mobile phone number + type: string + Product: + description: Details of the product for which the payment is made. + type: object + properties: + name: + description: Name of the product from the merchant's catalog. + type: string + price: + description: Price of the product without VAT. + type: number + format: float + price_with_vat: + description: Price of a single product item with VAT. + type: number + format: float + quantity: + description: Number of product items for the purchase. + type: number + single_vat_amount: + description: 'Amount of the VAT for a single product item (calculated as the product of `price` and `vat_rate`, i.e. `single_vat_amount = price * vat_rate`).' + type: number + format: float + total_price: + description: 'Total price of the product items without VAT (calculated as the product of `price` and `quantity`, i.e. `total_price = price * quantity`).' + type: number + format: float + total_with_vat: + description: 'Total price of the product items including VAT (calculated as the product of `price_with_vat` and `quantity`, i.e. `total_with_vat = price_with_vat * quantity`).' + type: number + format: float + vat_amount: + description: 'Total VAT amount for the purchase (calculated as the product of `single_vat_amount` and `quantity`, i.e. `vat_amount = single_vat_amount * quantity`).' + type: number + format: float + vat_rate: + description: VAT rate applicable to the product. + type: number + format: float + Reader: + description: A physical card reader device that can accept in-person payments. + type: object + properties: + created_at: + description: Reader creation timestamp. + type: string + format: date-time + example: '2023-01-18T15:16:17Z' + device: + $ref: '#/components/schemas/ReaderDevice' + id: + $ref: '#/components/schemas/ReaderID' + meta: + $ref: '#/components/schemas/Meta' + name: + $ref: '#/components/schemas/ReaderName' + status: + $ref: '#/components/schemas/ReaderStatus' + updated_at: + description: Reader last-modification timestamp. + type: string + format: date-time + example: '2023-01-20T15:16:17Z' + required: + - id + - name + - status + - device + - created_at + - updated_at + title: Reader + ReaderCheckoutStatusChange: + description: | + The callback payload containing the status change of the Reader Checkout. + type: object + properties: + event_type: + description: The event type. + type: string + example: solo.transaction.updated + id: + description: The unique event id. + type: string + format: uuid + example: 123e4567-e89b-12d3-a456-426614174000 + payload: + description: The event payload. + type: object + properties: + client_transaction_id: + description: The unique client transaction id. It is the same returned by the Checkout. + type: string + format: uuid + example: ba0a3c07-799e-40f8-89e9-1dfe96e4557e + merchant_code: + description: The target merchant code owner of the transaction. + type: string + example: M1234567 + status: + description: The status of the transaction. + type: string + example: successful + enum: + - successful + - failed + transaction_id: + description: The unique transaction id. + type: string + format: uuid + example: c88032e4-a384-4030-943c-ac59cc768d90 + deprecated: true + required: + - client_transaction_id + - merchant_code + - status + timestamp: + description: The timestamp of the event. + type: string + format: date-time + example: '2021-01-01T00:00:00Z' + required: + - id + - event_type + - payload + - timestamp + ReaderDevice: + description: | + Information about the underlying physical device. + type: object + properties: + identifier: + description: A unique identifier of the physical device (e.g. serial number). + type: string + example: U1DT3NA00-CN + model: + description: Identifier of the model of the device. + type: string + example: solo + enum: + - solo + - virtual-solo + required: + - identifier + - model + ReaderID: + description: | + Unique identifier of the object. + + Note that this identifies the instance of the physical devices pairing with your SumUp account. + + If you DELETE a reader, and pair the device again, the ID will be different. Do not use this ID to refer to a physical device. + type: string + example: rdr_3MSAFM23CK82VSTT4BN6RWSQ65 + maxLength: 30 + minLength: 30 + x-go-type: readers.ReaderID + x-go-type-import: + path: github.com/sumup/identity/apps/portier-backend/internal/domain/readers + ReaderName: + description: | + Custom human-readable, user-defined name for easier identification of the reader. + type: string + example: Frontdesk + maxLength: 500 + ReaderPairingCode: + description: | + The pairing code is a 8 or 9 character alphanumeric string that is displayed on a SumUp Device after initiating the pairing. + It is used to link the physical device to the created pairing. + type: string + example: 4WLFDSBF + maxLength: 9 + minLength: 8 + ReaderStatus: + description: |- + The status of the reader object gives information about the current state of the reader. + + Possible values: + + - `unknown` - The reader status is unknown. + - `processing` - The reader is created and waits for the physical device to confirm the pairing. + - `paired` - The reader is paired with a merchant account and can be used with SumUp APIs. + - `expired` - The pairing is expired and no longer usable with the account. The resource needs to get recreated + type: string + example: paired + enum: + - unknown + - processing + - paired + - expired + Receipt: + type: object + properties: + acquirer_data: + type: object + properties: + authorization_code: + type: string + local_time: + type: string + return_code: + type: string + tid: + type: string + emv_data: + type: object + merchant_data: + $ref: '#/components/schemas/ReceiptMerchantData' + transaction_data: + $ref: '#/components/schemas/ReceiptTransaction' + title: Receipt + ReceiptCard: + type: object + properties: + last_4_digits: + description: Card last 4 digits. + type: string + type: + description: Card Scheme. + type: string + ReceiptEvent: + type: object + properties: + amount: + $ref: '#/components/schemas/AmountEvent' + id: + $ref: '#/components/schemas/EventID' + receipt_no: + type: string + status: + $ref: '#/components/schemas/EventStatus' + timestamp: + $ref: '#/components/schemas/TimestampEvent' + transaction_id: + $ref: '#/components/schemas/TransactionID' + type: + $ref: '#/components/schemas/EventType' + ReceiptMerchantData: + description: Receipt merchant data + type: object + properties: + locale: + type: string + merchant_profile: + type: object + properties: + address: + type: object + properties: + address_line1: + type: string + city: + type: string + country: + type: string + country_en_name: + type: string + country_native_name: + type: string + landline: + type: string + post_code: + type: string + business_name: + type: string + email: + type: string + merchant_code: + type: string + ReceiptTransaction: + description: Transaction information. + type: object + properties: + amount: + description: Transaction amount. + type: string + card: + $ref: '#/components/schemas/ReceiptCard' + currency: + description: Transaction currency. + type: string + entry_mode: + description: Transaction entry mode. + type: string + events: + description: Events + type: array + items: + $ref: '#/components/schemas/ReceiptEvent' + installments_count: + description: Number of installments. + type: integer + payment_type: + description: Transaction type. + type: string + products: + description: Products + type: array + items: + properties: + description: + description: Product description. + type: string + name: + description: Product name. + type: string + price: + description: Product price. + type: number + format: float + quantity: + description: Product quantity. + type: integer + total_price: + description: Quantity x product price. + type: number + format: float + type: object + receipt_no: + description: Receipt number + type: string + status: + description: Transaction processing status. + type: string + timestamp: + description: Time created at. + type: string + format: date-time + tip_amount: + description: Tip amount (included in transaction amount). + type: string + transaction_code: + description: Transaction code. + type: string + vat_amount: + description: Transaction VAT amount. + type: string + vat_rates: + description: Vat rates. + type: array + items: + properties: + gross: + description: Gross + type: number + format: float + net: + description: Net + type: number + format: float + rate: + description: Rate + type: number + format: float + vat: + description: Vat + type: number + format: float + type: object + verification_method: + description: Cardholder verification method. + type: string + TimeoffsetDetails: + description: TimeOffset Details + type: object + properties: + dst: + description: Daylight Saving Time + type: boolean + offset: + description: UTC offset + type: number + post_code: + description: Postal code + type: string + TimestampEvent: + description: Date and time of the transaction event. + type: string + format: date-time + TransactionEvent: + description: Details of a transaction event. + type: object + properties: + amount: + $ref: '#/components/schemas/AmountEvent' + date: + description: Date when the transaction event occurred. + type: string + format: date + due_date: + description: Date when the transaction event is due to occur. + type: string + format: date + event_type: + $ref: '#/components/schemas/EventType' + id: + $ref: '#/components/schemas/EventID' + installment_number: + description: 'Consecutive number of the installment that is paid. Applicable only payout events, i.e. `event_type = PAYOUT`.' + type: integer + status: + $ref: '#/components/schemas/EventStatus' + timestamp: + $ref: '#/components/schemas/TimestampEvent' + TransactionFull: + allOf: + - $ref: '#/components/schemas/TransactionMixinBase' + - $ref: '#/components/schemas/TransactionMixinCheckout' + - $ref: '#/components/schemas/TransactionMixinHistory' + - properties: + card: + $ref: '#/components/schemas/CardResponse' + events: + description: List of events related to the transaction. + type: array + items: + $ref: '#/components/schemas/Event' + uniqueItems: true + horizontal_accuracy: + $ref: '#/components/schemas/HorizontalAccuracy' + lat: + $ref: '#/components/schemas/Lat' + links: + description: List of hyperlinks for accessing related resources. + type: array + items: + anyOf: + - $ref: '#/components/schemas/Link' + - $ref: '#/components/schemas/LinkRefund' + uniqueItems: true + local_time: + description: Local date and time of the creation of the transaction. + type: string + format: date-time + location: + description: Details of the payment location as received from the payment terminal. + type: object + properties: + horizontal_accuracy: + $ref: '#/components/schemas/HorizontalAccuracy' + lat: + $ref: '#/components/schemas/Lat' + lon: + $ref: '#/components/schemas/Lon' + lon: + $ref: '#/components/schemas/Lon' + payout_type: + description: Payout type for the transaction. + type: string + enum: + - BANK_ACCOUNT + - BALANCE + - PREPAID_CARD + products: + description: List of products from the merchant's catalogue for which the transaction serves as a payment. + type: array + items: + $ref: '#/components/schemas/Product' + simple_payment_type: + description: Simple name of the payment type. + type: string + enum: + - MOTO + - CASH + - CC_SIGNATURE + - ELV + - CC_CUSTOMER_ENTERED + - MANUAL_ENTRY + - EMV + simple_status: + description: Status generated from the processing status and the latest transaction state. + type: string + enum: + - SUCCESSFUL + - PAID_OUT + - CANCEL_FAILED + - CANCELLED + - CHARGEBACK + - FAILED + - REFUND_FAILED + - REFUNDED + - NON_COLLECTION + tax_enabled: + description: Indicates whether tax deduction is enabled for the transaction. + type: boolean + transaction_events: + description: List of transaction events related to the transaction. + type: array + items: + $ref: '#/components/schemas/TransactionEvent' + username: + description: Email address of the registered user (merchant) to whom the payment is made. + type: string + format: email + vat_rates: + description: List of VAT rates applicable to the transaction. + type: array + items: {} + verification_method: + description: Verification method used for the transaction. + type: string + enum: + - none + - signature + - offline pin + - online pin + - offline pin + signature + - confirmation code verified + type: object + TransactionHistory: + allOf: + - $ref: '#/components/schemas/TransactionMixinBase' + - $ref: '#/components/schemas/TransactionMixinHistory' + - properties: + card_type: + description: Issuing card network of the payment card used for the transaction. + type: string + enum: + - VISA + - AMEX + - CUP + - DINERS + - DISCOVER + - ELO + - ELV + - HIPERCARD + - JCB + - MAESTRO + - MASTERCARD + - VISA_ELECTRON + - VISA_VPAY + - UNKNOWN + client_transaction_id: + description: Client-specific ID of the transaction. + type: string + transaction_id: + $ref: '#/components/schemas/TransactionID' + type: + description: Type of the transaction for the registered user specified in the `user` property. + type: string + enum: + - PAYMENT + - REFUND + - CHARGE_BACK + user: + description: Email address of the registered user (merchant) to whom the payment is made. + type: string + format: email + type: object + TransactionID: + description: Unique ID of the transaction. + type: string + TransactionMixinBase: + description: Details of the transaction. + type: object + properties: + amount: + description: Total amount of the transaction. + type: number + format: float + example: 10.1 + currency: + $ref: '#/components/schemas/Currency' + id: + description: Unique ID of the transaction. + type: string + example: 6b425463-3e1b-431d-83fa-1e51c2925e99 + installments_count: + description: Current number of the installment for deferred payments. + type: integer + minimum: 1 + payment_type: + description: Payment type used for the transaction. + type: string + enum: + - ECOM + - RECURRING + - BOLETO + status: + description: Current status of the transaction. + type: string + enum: + - SUCCESSFUL + - CANCELLED + - FAILED + - PENDING + timestamp: + description: 'Date and time of the creation of the transaction. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.' + type: string + format: date-time + example: '2020-02-29T10:56:56.876Z' + transaction_code: + description: Transaction code returned by the acquirer/processing entity after processing the transaction. + type: string + example: TEENSK4W2K + TransactionMixinCheckout: + type: object + properties: + auth_code: + description: Authorization code for the transaction sent by the payment card issuer or bank. Applicable only to card payments. + type: string + example: '053201' + entry_mode: + description: Entry mode of the payment details. + type: string + enum: + - CUSTOMER_ENTRY + - BOLETO + internal_id: + description: Internal unique ID of the transaction on the SumUp platform. + type: integer + example: 1763892018 + merchant_code: + description: Unique code of the registered merchant to whom the payment is made. + type: string + example: MH4H92C7 + tip_amount: + description: Amount of the tip (out of the total transaction amount). + type: number + format: float + example: 3 + vat_amount: + description: Amount of the applicable VAT (out of the total transaction amount). + type: number + format: float + example: 6 + TransactionMixinHistory: + type: object + properties: + payout_plan: + description: Payout plan of the registered user at the time when the transaction was made. + type: string + enum: + - SINGLE_PAYMENT + - TRUE_INSTALLMENT + - ACCELERATED_INSTALLMENT + payouts_received: + description: Number of payouts that are made to the registered user specified in the `user` property. + type: integer + payouts_total: + description: Total number of payouts to the registered user specified in the `user` property. + type: integer + product_summary: + description: Short description of the payment. The value is taken from the `description` property of the related checkout resource. + type: string + VatRates: + description: Merchant VAT rates + type: object + properties: + country: + description: Country ISO code + type: string + description: + description: Description + type: string + id: + description: Internal ID + type: number + ordering: + description: Ordering + type: number + rate: + description: Rate + type: number + examples: + CreatedReader: + summary: A reader that waits for the physical device to acknowledge the pairing. + value: + created_at: '2023-05-09T14:50:20.214Z' + device: + identifier: U1DT3NA00-CN + model: solo + id: rdr_3MSAFM23CK82VSTT4BN6RWSQ65 + name: Frontdesk + status: processing + updated_at: '2023-05-09T14:52:58.714Z' + links: + DeleteReaderByID: + description: | + Delete the reader. + operationId: DeleteReader + parameters: + id: $response.body#/id + UpdateReaderByID: + description: | + Update the reader object. This can be used to set a name after using this endpoint to verify the pairing code. + operationId: UpdateReader + parameters: + id: $response.body#/id + securitySchemes: + accessToken: + description: | + At SumUp authentication uses your API credentials and Basic HTTP auth. The API credentials consist of a `client_id` and `client_secret` key-value pair. + + It is possible to create multiple API credentials for each of the applications you connect with your SumUp Profile. + + Use the API credentials as an authorization header for requests that require such. + + Authorization + --------- + + SumUp uses the [OAuth 2.0 authorization framework](https://tools.ietf.org/html/rfc6749) and supports [two authorization flows](https://developer.sumup.com/docs/authorization/#authorization-flows) for [obtaining an access token](https://developer.sumup.com/docs/register-app/#3-create-oauth-client-credentials). + + The flow you choose will grant your access token-specific permissions. All API calls should include the obtained access token in the `Authorization: Bearer <>` format. + + To complete successful requests, ensure you have requested the [necessary scopes](https://developer.sumup.com/docs/authorization/#authorization-scopes) for your authorization flow of choice. + flows: + authorizationCode: + authorizationUrl: 'https://api.sumup.com/authorize' + refreshUrl: 'https://api.sumup.com/token' + scopes: + payment_instruments: Manage customers and their payment instruments. + payments: Make payments by creating and processing checkouts. + transactions.history: View transactions and transaction history. + user.app-settings: View and manage the SumUp mobile application settings. + user.payout-settings: View and manage your payout settings. + user.profile: View and manage your user profile. + user.profile_readonly: View user profile details. + user.subaccounts: View and manage the user profile details of your employees. + tokenUrl: 'https://api.sumup.com/token' + clientCredentials: + scopes: + payment_instruments: Manage customers and their payment instruments. + payments: Make payments by creating and processing checkouts. + transactions.history: View transactions and transaction history. + user.app-settings: View and manage the SumUp mobile application settings. + user.payout-settings: View and manage your payout settings. + user.profile: View and manage your user profile. + user.profile_readonly: View user profile details. + user.subaccounts: View and manage the user profile details of your employee. + tokenUrl: 'https://api.sumup.com/token' + type: oauth2 +tags: + - description: | + SumUp API uses [API keys](/online-payments/introduction/authorization#api-keys) for authentication. + You can view and manage your API keys in the [API Keys](/api-keys) section of the [Developer Portal](/). + + + API keys are short static tokens that are passed in the `Authorization` header to authenticate the requests. + + + The tokens have a `sup_sk_` prefix. Your API keys have access to the whole SumUp API, so make sure to keep them secure. + + + All requests must be made over [HTTPS](https://en.wikipedia.org/wiki/HTTPS) and must be authenticated. + + + Alternatively, SumUp APIs support [OAuth2](/online-payments/introduction/authorization#oauth-20) authentication for applications that want to use SumUp as a platform for other users. + + + Read more about authorization in our [Authorization guide](/online-payments/introduction/authorization). + name: Authorization + - description: | + Accept payments from your end users by adding the Checkouts model to your platform. + SumUp supports standard and single payment 3DS checkout flows. + + The Checkout model allows creating, listing, retrieving, processing and deactivating checkouts. + A payment is completed by creating a checkout and then processing the checkout. + name: Checkouts + x-core-objects: + - $ref: '#/components/schemas/Checkout' + - description: | + Allow your regular customers to save their information with the Customers model. + This will prevent re-entering payment instrument information for recurring payments on your platform. + + Depending on the needs you can allow, creating, listing or deactivating payment instruments & creating, retrieving and updating customers. + name: Customers + x-core-objects: + - $ref: '#/components/schemas/Customer' + - description: | + Retrieve details for a specific transaction by it’s `id` + or any other required query parameter, or list all transactions related to the merchant account. + name: Transactions + - description: | + The Payouts model will allow you to track funds you’ve received from SumUp. + You can receive a detailed payouts list with information like dates, fees, references and statuses, using the `List payouts` endpoint. + name: Payouts + x-core-objects: + - $ref: '#/components/schemas/FinancialPayouts' + - description: The Receipts model obtains receipt-like details for specific transactions. + name: Receipts + x-core-objects: + - $ref: '#/components/schemas/Receipt' + - description: Manage merchant profile. + name: Merchant + x-core-objects: + - $ref: '#/components/schemas/MerchantAccount' + - description: | + API Keys allow your application to gain programmatic access to SumUp. + API Keys allow application to do authorized requests within the SumUp ecosystem. API Keys are scopes to single account and thus can't be used for endpoints where user presence is needed (for such endpoints it is necessary to use OAuth2). + name: API Keys + x-core-objects: + - $ref: '#/components/schemas/APIKey' + - description: | + Endpoints for managing merchant sub-accounts (operators). + name: Subaccounts + x-core-objects: + - $ref: '#/components/schemas/Operator' + - description: | + Endpoints to manage account members. Members are users that have membership within merchant accounts. + name: Members + x-beta: true + x-core-objects: + - $ref: '#/components/schemas/Member' + - description: | + A reader represents a device that accepts payments. You can use the SumUp Solo to accept in-person payments. + name: Readers + x-beta: true + x-core-objects: + - $ref: '#/components/schemas/Reader'