1.0.1 • Published 2 years ago

sumup-rest-api v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

This repo is generated using Swagger Codegen

SumUp REST API

SumUpRestApi - JavaScript client for sumup-rest-api 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, please contact us for a test account. When you receive your test account you can create your client credentials and process different requests with real payment instruments, without charging them. # Authentication This SDK is automatically generated by the Swagger Codegen project:

  • API version: 1.0.0
  • Package version: 1.0.0
  • Build package: io.swagger.codegen.v3.generators.javascript.JavaScriptClientCodegen

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install sumup-rest-api --save

git

If the library is hosted at a git repository, e.g. https://github.com/GIT_USER_ID/GIT_REPO_ID then install it via:

    npm install GIT_USER_ID/GIT_REPO_ID --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Webpack Configuration

Using Webpack you may encounter the following error: "Module not found: Error: Cannot resolve module", most certainly you should disable AMD loader. Add/merge the following section to your webpack config:

module: {
  rules: [
    {
      parser: {
        amd: false
      }
    }
  ]
}

Getting Started

Please follow the installation instruction and execute the following JS code:

var SumUpRestApi = require('sumup-rest-api');
var defaultClient = SumUpRestApi.ApiClient.instance;

// Configure OAuth2 access token for authorization: accessToken
var accessToken = defaultClient.authentications['accessToken'];
accessToken.accessToken = "YOUR ACCESS TOKEN"

var api = new SumUpRestApi.AccountDetailsApi()
var opts = { 
  'include': ["include_example"] // {[String]} A list of additional information you want to receive for the user. By default only personal and merchant profile information will be returned.
};
var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.meGet(opts, callback);

Documentation for API Endpoints

All URIs are relative to https://api.sumup.com/{version}

ClassMethodHTTP requestDescription
SumUpRestApi.AccountDetailsApimeGetGET /meRetrieve an account
SumUpRestApi.AuthorizationApiauthorizeGetGET /authorizeRequest authorization from users
SumUpRestApi.AuthorizationApitokenPostPOST /tokenGenerate a token
SumUpRestApi.CheckoutsApicheckoutsGetGET /checkoutsList checkouts
SumUpRestApi.CheckoutsApicheckoutsIdDeleteDELETE /checkouts/{id}Deactivate a checkout
SumUpRestApi.CheckoutsApicheckoutsIdGetGET /checkouts/{id}Retrieve a checkout
SumUpRestApi.CheckoutsApicheckoutsIdPutPUT /checkouts/{id}Process a checkout
SumUpRestApi.CheckoutsApicheckoutsPostPOST /checkoutsCreate a checkout
SumUpRestApi.CustomersApicustomersCustomerIdGetGET /customers/{customer_id}Retrieve a customer
SumUpRestApi.CustomersApicustomersCustomerIdPaymentInstrumentsGetGET /customers/{customer_id}/payment-instrumentsList payment instruments
SumUpRestApi.CustomersApicustomersCustomerIdPaymentInstrumentsPostPOST /customers/{customer_id}/payment-instrumentsCreate a payment instrument
SumUpRestApi.CustomersApicustomersCustomerIdPaymentInstrumentsTokenDeleteDELETE /customers/{customer_id}/payment-instruments/{token}Deactivate a payment instrument
SumUpRestApi.CustomersApicustomersCustomerIdPutPUT /customers/{customer_id}Update a customer
SumUpRestApi.CustomersApicustomersPostPOST /customersCreate a customer
SumUpRestApi.MerchantAccountApimeMerchantProfileBankAccountsGetGET /me/merchant-profile/bank-accountsList bank accounts
SumUpRestApi.MerchantAccountApimeMerchantProfileDoingBusinessAsGetGET /me/merchant-profile/doing-business-asRetrieve DBA
SumUpRestApi.MerchantAccountApimeMerchantProfileGetGET /me/merchant-profileRetrieve a profile
SumUpRestApi.MerchantAccountApimeMerchantProfileSettingsGetGET /me/merchant-profile/settingsList settings
SumUpRestApi.PayoutsApimeFinancialsPayoutsGetGET /me/financials/payoutsList payouts
SumUpRestApi.PayoutsApimeFinancialsTransactionsGetGET /me/financials/transactionsList transactions
SumUpRestApi.PersonalAccountApimePersonalProfileGetGET /me/personal-profileRetrieve a profile
SumUpRestApi.ReceiptsApireceiptsIdGetGET /receipts/{id}Retrieve receipt details
SumUpRestApi.RefundsApimeRefundTxnIdPostPOST /me/refund/{txn_id}Refund a transaction
SumUpRestApi.SubaccountsApimeAccountsGetGET /me/accountsList subaccounts
SumUpRestApi.SubaccountsApimeAccountsOperatorCodeDeleteDELETE /me/accounts/{operator_code}Deactivate a subaccount
SumUpRestApi.SubaccountsApimeAccountsOperatorCodePutPUT /me/accounts/{operator_code}Update a subaccount
SumUpRestApi.SubaccountsApimeAccountsPostPOST /me/accountsCreate a subaccount
SumUpRestApi.TransactionsApimeTransactionsGetGET /me/transactionsRetrieve a transaction
SumUpRestApi.TransactionsApimeTransactionsHistoryGetGET /me/transactions/historyList transactions

Documentation for Models

Documentation for Authorization

accessToken

  • Type: OAuth
  • Flow: application
  • Authorization URL:
  • Scopes:
    • :