EPC API for calling Electrum (17.1.0)

The Electrum EPC API for calling Electrum is an asynchronous API that allows Corporate Clients to participate in various nationally regulated payment schemes This document describes the operations exposed by Electrum for partners to consume in order to initiate outbound or respond to inbound payments.

Download OpenAPI description

epc-elpapi-redoc.json

epc-elpapi-redoc.yaml

Overview

URL

https://electrum.co.za

Electrum Support

support@electrum.co.za

License

proprietary

Servers

Mock server

https://docs.electrumsoftware.com/_mock/openapi/epc-cicd/epc-elpapi-redoc/

Payments API sandbox

https://example.com/path/payments/api/v1/

credit-transfer

Operations related to credit transfer transactions.

Operations

scheme-inquiry

Operations that are related to retrieving information from industry for a particular scheme.

Operations

request-to-pay

Operations which pertain to a request for payment from a creditor to a debtor

Operations

Schema

TaxAuthorisation

namestring[ 1 .. 140 ] characters

Name of the tax payer or tax payer's authorised representative

titlestring[ 1 .. 35 ] characters

Title or position of the tax payer or tax payer's authorised representative

{
  "name": "string",
  "title": "string"
}

AuthorisedTaxParty

registrationIdentificationstring[ 1 .. 35 ] characters

Unique identification, as assigned by an organisation, to unambiguously identify a party

taxIdentificationstring[ 1 .. 35 ] characters

Tax identification number

taxTypestring[ 1 .. 35 ] characters

Type of tax payer.

authorisationobject(TaxAuthorisation)

{
  "registrationIdentification": "string",
  "taxIdentification": "string",
  "taxType": "string",
  "authorisation": {
    "name": "string",
    "title": "string"
  }
}

TaxRemittance

creditorobject(TaxParty)

datestring(date)

Date by which tax is due

debtorobject(AuthorisedTaxParty)

referenceNumberstring[ 1 .. 140 ] characters

Tax reference information that is specific to a taxing agency.

sequenceNumberinteger(int64)

Sequential number of the tax report.

totalTaxAmountobject(Amount)

totalTaxableBaseAmountobject(Amount)

ultimateDebtorobject(AuthorisedTaxParty)

{
  "creditor": {
    "registrationIdentification": "string",
    "taxIdentification": "string",
    "taxType": "string"
  },
  "date": "2019-08-24",
  "debtor": {
    "registrationIdentification": "string",
    "taxIdentification": "string",
    "taxType": "string",
    "authorisation": { … }
  },
  "referenceNumber": "string",
  "sequenceNumber": 0,
  "totalTaxAmount": {
    "currency": "string",
    "value": 0.1
  },
  "totalTaxableBaseAmount": {
    "currency": "string",
    "value": 0.1
  },
  "ultimateDebtor": {
    "registrationIdentification": "string",
    "taxIdentification": "string",
    "taxType": "string",
    "authorisation": { … }
  }
}

transactional

Operations

financial

Operations

identifier-determination

Operations

bulk

Operations

refund

Operations