Getting started

Welcome Getting help About

OpenAPI 3.0. Postman

Guides Overview

Create an Account Create an Organization Create and Send an Invoice Conclusion

Onboard a merchant Create and Send an Invoice

Enable Payment Processing Onboard an Organization Pay now button Create a Payment Intent Create a recurring charge

Enable Stripe Connect Onboard an Organization Pay now button

Enable Stripe Connect Onboard an Organization Generate an onboarding link Pay now button

Prerequisites Upload a Certificate Add a Business Premise Add an Electronic Device Go Live

Concepts Data Hierarchy Implementation Flow Authentication

Filters Where operators

Pagination

Introduction Supported locales Localizing user content Localizing Document content Localizing Item content Localizing defaults Localizing non-user content

Smart codes Model custom data

Introduction Decimal places Rounding

Replayable requests Rate limits Soft delete Errors Core Resources

Introduction The AccessToken Object Create AccessToken Find AccessTokens Delete AccessToken

Introduction The Account Object Create Account Get Account Patch Account Login Account Logout Account Login as / Impersonate Child Account Find Child Accounts Count Child Accounts Check if Account Authorized Check if Email is unique Verify Account Confirm Account Change Account password Request Account password reset Reset Account password Check if Account verified Request Account verification

Introduction The Category Object Create Category Get Category Find Categories Count Categories Replace Category Delete Category

Introduction The DocumentCategory Object Create DocumentCategory Find DocumentCategories Count DocumentCategories Replace DocumentCategory Patch DocumentCategory Delete DocumentCategory

Introduction The Client Object Create Client Get Client Find Clients Count Clients Search Clients Replace Client Patch Client Delete Client Send overdue reminder to Client

Introduction The Default Object Create Default Get Default Find Defaults Count Defaults Replace Default Patch Default Delete Default

Introduction The Document Object Create Document Get Document Find Documents Count Documents Replace Document Patch Document Delete Document Send a Document Download PDF Cancel Document Uncancel Document Fiscally verify Document Mark Document as sent Upload Attachment Download Document XML in E-slog format Parse to XML Share Document Get Document using shareableId Download XML in E-slog format using shareableId Download PDF using shareableId Download Attachment using shareableId Check is unique Document number Get last Document number Get next Document number Parse image to Document Create Comment Replace Comment Delete Comment

Introduction The EmailAddress Object Create EmailAddress on Account Get Account EmailAddresses Delete Account EmailAddress Get Account EmailAddress status Resend Account EmailAddress verification Create EmailAddress on Organization Get Organization EmailAddresses Delete Organization EmailAddress Get Organization EmailAddress status Resend Organization EmailAddress verification

Introduction The Item Object Create Item Get Item Find Items Count Items Search Items Replace Item Delete Item Find Item Inventories

Introduction The Organization Object Create Organization Get Organization Find Organizations Count Organizations Patch Organization Activate Organization Deactivate Organization Get Organization Subscription Upload Image for Organization Get Image for Organization Delete Image for Organization Download Image for Organization Download Organization Logo Export Organization Data Import Data for Organization Invite to Organization Get Organization Business Stats Get Organization Grouped Stats Get Organization Payment Stats Get Organization Category Stats Get Organization Document Stats Get Organization Profit-and-Loss report Get Organization Balance Sheet report Delete AccountOrganization Accept AccountOrganization Reject AccountOrganization Enable AccountOrganization Disable AccountOrganization Change AccountOrganization Role Find AccountOrganizations Count AccountOrganizations

Introduction The Payment Object Create Payment Get Payment Find Payments Count Payments Replace Payment Delete Payment Create Payment for Document Get Document's Payments Count Document's Payments

Introduction The PriceList Object Create PriceList Get PriceList Find PriceLists Count PriceLists Patch PriceList Delete PriceList Create Price for PriceList Find PricerList's Prices Count PriceList's Prices Patch Price Delete Price

Introduction The Recurrence Object Create Recurrence for Document Get Recurrence Find Recurrences Count Recurrences Replace Recurrence Delete Recurrence Get Document's Recurrence

Introduction The Tax Object Create Tax Get Tax Find Taxes Count Taxes Replace Tax Delete Tax Create TaxRate for Tax Delete Tax TaxRate Get Tax Clause

Introduction The Unit Object Create Unit Find Units Count Units Patch Unit Delete Unit Get last Document number for Unit Get next Document number for Unit Upload image for Unit Download Unit's image Delete Unit's image

Introduction The Warehouse Object Create Warehouse Get Warehouse Find Warehouses Count Warehouses Replace Warehouse Patch Warehouse Delete Warehouse

Payment Processing

Introduction The StripeConnect Object Create StripeConnect Get StripeConnect Patch StripeConnect Create StripeConnectAccount Get StripeConnectAccount Patch StripeConnectAccount Get StripeConnectAccount On-boarding Link Get Document's PaymentIntent

Other resources

Introduction The Country Object Find Countries

Introduction The Currency Object Find Currencies

Introduction The Webhook Object Create Webhook Get Webhook Find Webhooks Count Webhooks Replace Webhook Patch Webhook Delete Webhook

Introduction The WhiteLabel Object Find WhiteLabels Patch WhiteLabel

Connectors

Introduction The Bokun Object Create Bokun Find Bokuns Count Bokuns Patch Bokun Delete Bokun Import Bokun COD payments

Introduction The CustomIntegration Object Create CustomIntegration Find CustomIntegrations Count CustomIntegrations Patch CustomIntegration Delete CustomIntegration Import CustomIntegration COD payments

Introduction The Magento1 Object Create Magento1 Find Magento1s Count Magento1s Patch Magento1 Delete Magento1 Import Magento1 COD payments

Introduction The Order Object Get Order Find Orders Count Orders Create Document for Order

Introduction The Shopamine Object Create Shopamine Find Shopamines Count Shopamines Patch Shopamine Delete Shopamine Import Shopamine COD payments

Introduction The Shopify Object Create Shopify Find Shopifys Count Shopifys Patch Shopify Delete Shopify Import Shopify COD payments Create Document for Shopify order Get Shopify

Introduction The Stripe Object Create Stripe Find Stripes Count Stripes Patch Stripe Delete Stripe

Introduction The Thrivecart Object Create Thrivecart Find Thrivecarts Count Thrivecarts Patch Thrivecart Delete Thrivecart Import Thrivecart COD payments

Introduction The TicketingHub Object Create TicketingHub Find TicketingHubs Count TicketingHubs Replace TicketingHub Delete TicketingHub

Introduction The Woocommerce Object Create Woocommerce Find Woocommerces Count Woocommerces Patch Woocommerce Delete Woocommerce Import Woocommerce COD payments

Real-time reporting

Introduction The Fina Object Upload Certificate Check has Certificate

Introduction The Furs Object Upload Certificate Check has Certificate

Introduction The BusinessPremise Object Create BusinessPremises Find BusinessPremises Delete BusinessPremise Patch BusinessPremise Find BusinessPremise's ElectronicDevices

Introduction The ElectronicDevice Object Create ElectronicDevice Find ElectronicDevices Patch ElectronicDevice

UI Invoicing App UI SDK Changelog Changelog

Payment Processing setup

The Space Invoices API handles all the necessary setup for processing stand-alone and invoice-based payments and collecting platform application fees for online payments. With our cloud-hosted UI, no additional development is required to enable this feature.

Our services include:

Simple on-boarding for Organizations via our cloud-hosted UI
A online invoice view page with an integrated "Pay now" button to collect payments directly on invoices
Stand alone payment collection page
Automated invoice status changes based on collected payments
Automatic application fee collection with customization options

Enable Payment Processing

Enabling Payment Processing is a straightforward task within the Space Invoices platform. Here’s how to go about it:

Begin by logging into your Space Invoices account at spaceinvoices.com.
Once logged in, navigate to the Payment Processing section from the menu.
Within the Payment Processing section, locate the Space Payments box and click on the Set up button.

Now, you'll need to provide some data for configuration:

Application Fee %: Define the application fee percentage you aim to collect from Connect account charges.
Payment Complete Return URL (Optional): Specify a URL to which users will be redirected post the completion of invoice payments.

Following this, a Verification window will appear on the same page. Click on Open Form to initiate the verification step.

Upon completing these steps, you're ready to advance to the next section: onboarding Organizations. This will further streamline your payment processing journey and enhance your invoicing capabilities.

Onboard an Organization

Each Organization needs to be onboarded to enable collecting payments on invoices. We've made sure the process is as simple as possible for you and your users.

To initiate the onboarding process using our provided UI, direct your users to navigate to https://app.getapollo.io (or your provided white-label domain) and click on Settings > Payment Processing.

The Payment Processing menu item will only become available after Payment Processing has been enabled on your Space Invoices account (step 1 of this guide).

The user will be redirected to an onboarding page, where they will provide additional details about their organization required to complete the onboarding process.

Once an organization has been successfully onboarded and approved, the Payment Processing feature gets activated automatically. This means that a "Pay Now" button will now be visible on all issued invoices.

"Pay now" button

After the onboarding process is completed, any invoice shared with a client using the send endpoint will automatically include a "Pay" button and a checkout form for convenient payment processing.

Space Invoices takes care of automatically marking invoices as paid once the payment has been successfully processed. This ensures that your invoice management remains streamlined and up-to-date, allowing you to focus on other aspects of your business.

Create a Payment Intent

To create a custom checkout flow a Payment Intent can be created via the Space Invoices API.

"amount" Amount to charge i.e. 100 for one hundred.

"currencyid" (optional) Currency to collect payment in. Automatically populated based on organization default currency.

"allowRecurring" (optional) Enables capturing consecutive payments after this payment without additional user confirmation.

The returned Payment Intent object will contain a link to the checkout page in the "paymentLink" property.

      
        const response = await fetch('https://api.spaceinvoices.com/v1/organizations/{id}/payment-intents', {
  method: 'POST',
  headers: {
    "Authorization": "ACCESS_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "amount": 100,
    "reference": "123456",
    "returnURL": "https://example.com/payment-successful"
  })
});

Prerequisite: npm install node-fetch

        
          curl -X POST 'https://api.spaceinvoices.com/v1/organizations/{id}/payment-intents' \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100,
    "reference": "123456",
    "returnURL": "https://example.com/payment-successful"
  }'

        
          import requests
url = "https://api.spaceinvoices.com/v1/organizations/{id}/payment-intents"
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'Content-Type': 'application/json'
}
payload = {
  'amount': 100,
  'reference': '123456',
  'returnURL': 'https://example.com/payment-successful'
}
response = requests.post(url, json=payload, headers=headers)

Response:

    
      {
  "id": "644c214c6ee48100249d5d7d",
  "amount": 100,
  "reference": "123456",
  "returnURL": "https://example.com/payment-successful",
  "paymentLink": "https://pay.spaceinvoices.com/...",
  "organizationId": "5f1d2c6b6ee48100249d5d7d",
  "currencyId": "EUR",
  "status": "initiated",
  "expiresAt": "2023-04-28T19:41:00.930Z"
}

Create a recurring charge

To automatically charge a card based on a previously successful payment intent an authorized payment intent can be created.

"initialPaymentIntentId" ID of previous successfully paid Payment Intent. The same ID can be used for multiple consecutive payments.