Auth-Service

Intro
token
- Request tokenpost
- Introspect tokenpost
certificate
- Realm certget

Entities

Entity
Entity Contact
- Modify contact information of an identified Entity.put
- Delete contact information of an identified Entity.delete
Entity Alias
- updates reference information of an entity object.put
Entity Children
- Retrieving an identified Entity childrens.get
Entity Status
- Retrieving status of an identified Entity.get
- Set the status of an entity with entityId.put
Entity User
Entity User Status
- Referenced user status retrieval.get
- Update user status .put
Entity User Credentials
- Modification of user credentials.post
- Resetting the user credentials.post
Entity Metadata Type
Entity ProfileData Type

Wallets

Wallets
Payment methods
- Creates a wallet for a payment method.post
- Get paymentsMethodsget
Transactions
- View Wallet Specific Transactionget

Payment Methods

Payment method types
- Retrieves payment method types and their attributes.get
- Retrieves a single payment method type and its attributes.get
Payment methods
Payment methods links
- Creates a link between a payment method and a wallet.post
- It obtains wallet links for a specific payment method.get

Quotations

Quotations
- Creating a quotation.post
- Get a quotation.get

Transactions

Transactions
Transactions Types
Metadatakeys

Hosted Checkout

Introduction
Checkout Request
- Use the POST method to create a checkout page.post

Service Providers

Service Providers
Bills
- Gets the bills using a payment reference for a specific billing company.get
- Gets the bills using a payment reference for a specific billing company.get
Products
- Obtains the products offfered by a Seller company.get
- Obtains the products offfered by a Seller company.get

Issuing

Cards
TenantProduct
- Get all products of a tenantget
MCC
Tokenization

Issuing - Tokenization Events (Client Side)

/tokenizationEvent
- Tokenization events receptionput

Issuing - External Auth (client side)

External Authorization
- Request authorization to clientpost
- Inform authorization updateput

Giftcards API

Cards

KYC (Know Your Customer)

Documents
- Upload a documentpost
- Download A Documentget
Faces
- Upload a photo or video as a face proofpost
- Download A face proof Documentget
Checks
- Create a Checkpost
Reports
- Retrieve a Report Objectget
- List Reports related to a Check Objectget

SUBSCRIPTIONS API

Subscriptions
Payment
PaymentAttempt
- Get all payment attemptsget
- Retries a paymentpost

Remittance API

Remittances
Catalogs

Recipients API

Recipients
Payout Methods

VIRTUAL-ACCOUNTS API

VirtualAccounts

AccountValidator API

Account Validations
- Get the account validation data by id or correlation idget
- Initiate bank account ownership validationpost

Retrieves payment method types and their attributes.

get https://swagger.io/paymentmethodtypes

This endpoint returns the attributes for each payment method type.

URL Expired

The URL for this request expired after 30 days.

Query Params

country

string

Returns payment method types only available for a specific country.

storable

boolean

Returns only payment method types that can either be stored or not.

directUsage

boolean

Returns payment method types that can be used without having been previously stored.

direction

string

Query variable to filter payment method types by the direction of the funds (in/out).

paymentMethodTypeClass

string

Query parameter to filter by payment method type class.

paymentMethodTypeStatus

string

Query parameter to filter by payment method type status.

currency

string

Query variable to filter by the allowed Currency for the payment method type.

Headers

X-Date

date-time

Header parameter that displays the date and time when the message was originated. It is used for basic message integrity checks, to ensure the request is not stale. Note that the header was previously referenced as 'Date' in version 1.0 of the Mobile Money API.

apikey

string

It is used to send the pre-shared client API key to the server.

X-User-Bearer

string

required

It is used to send the user’s access token when OAuth 2.0/OIDC authorization framework is used for end-user authentication.

X-Channel

string

length ≤ 256

String containing the channel used to originate the request. For example USSD, Web, App.

Responses

Response body

array of objects

object

paymentMethodType

string

paymentMethodTypeStatus

string

available unavailable

paymentMethodTypeClass

string

bank digitalWallet card emoney cash

paymentMethodTypeDescription

string

fields

array of objects

fields

object

name

string

Identifies the field.

description

string

Describes the field.

regex

string

A regular expression used to validate the field.

mandatory

boolean

Informs whether the field is mandatory or not.

storable

boolean

Shows whether a payment method of this type can be added or not.

directUsage

boolean

Shows whether a payment method of this type can be used without having been previously added to the entity's wallet.

direction

string

Shows wether a payment method of this type can be used for funds in operations or funds out operations. Payment method types of emoney class have no direction.

in out

country

string

AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW

currencies

array of strings

currencies

imageURL

string

paymentMethodTypePos

array of objects

paymentMethodTypePos

object

name

string

imageURL

string

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Response body

object

errorCategory

string

required

It is the category grouping the error.

businessRule validation authorisation identification internal serviceUnavailable

errorCode

string

required

Harmonised error code identifying the error reason.

errordescription

string

length between 0 and 256

A text description of the error."

errorDateTime

date-time

Timestamp of the error.

errorParameters

array of objects

length ≤ 20

It is a collection of key/value pairs. These can be used to fill with additional object properties.

errorParameters

object

key

string

required

length between 1 and 256

Identifies the type of additional property.

value

string

required

length between 1 and 256

Identifies the value of the additional property.

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Response body

object

errorCategory

string

required

It is the category grouping the error.

businessRule validation authorisation identification internal serviceUnavailable

errorCode

string

required

Harmonised error code identifying the error reason.

errordescription

string

length between 0 and 256

A text description of the error."

errorDateTime

date-time

Timestamp of the error.

errorParameters

array of objects

length ≤ 20

It is a collection of key/value pairs. These can be used to fill with additional object properties.

errorParameters

object

key

string

required

length between 1 and 256

Identifies the type of additional property.

value

string

required

length between 1 and 256

Identifies the value of the additional property.

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Response body

object

errorCategory

string

required

It is the category grouping the error.

businessRule validation authorisation identification internal serviceUnavailable

errorCode

string

required

Harmonised error code identifying the error reason.

errordescription

string

length between 0 and 256

A text description of the error."

errorDateTime

date-time

Timestamp of the error.

errorParameters

array of objects

length ≤ 20

It is a collection of key/value pairs. These can be used to fill with additional object properties.

errorParameters

object

key

string

required

length between 1 and 256

Identifies the type of additional property.

value

string

required

length between 1 and 256

Identifies the value of the additional property.

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Response body

object

errorCategory

string

required

It is the category grouping the error.

businessRule validation authorisation identification internal serviceUnavailable

errorCode

string

required

Harmonised error code identifying the error reason.

errordescription

string

length between 0 and 256

A text description of the error."

errorDateTime

date-time

Timestamp of the error.

errorParameters

array of objects

length ≤ 20

It is a collection of key/value pairs. These can be used to fill with additional object properties.

errorParameters

object

key

string

required

length between 1 and 256

Identifies the type of additional property.

value

string

required

length between 1 and 256

Identifies the value of the additional property.

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Response body

object

errorCategory

string

required

It is the category grouping the error.

businessRule validation authorisation identification internal serviceUnavailable

errorCode

string

required

Harmonised error code identifying the error reason.

errordescription

string

length between 0 and 256

A text description of the error."

errorDateTime

date-time

Timestamp of the error.

errorParameters

array of objects

length ≤ 20

It is a collection of key/value pairs. These can be used to fill with additional object properties.

errorParameters

object

key

string

required

length between 1 and 256

Identifies the type of additional property.

value

string

required

length between 1 and 256

Identifies the value of the additional property.

Headers

object

X-Date

date-time

Date and time when the response message was sent.

Updated almost 2 years ago

View Wallet Specific Transaction

Retrieves a single payment method type and its attributes.

Language

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://swagger.io/paymentmethodtypes \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated almost 2 years ago

View Wallet Specific Transaction

Retrieves a single payment method type and its attributes.

Auth-Service
Intro
token
Introspect tokenpost
Request tokenpost
certificate
Realm certget

Entities
Entity
Updating properties of an Entity.patch
Entity deletion.delete
Modify an identified Entity.put
Retrieving an identified Entity.get
Creating a new Entity.post
Retrieving Entities.get
Entity Contact
Delete contact information of an identified Entity.delete
Modify contact information of an identified Entity.put
Entity Alias
updates reference information of an entity object.put
Entity Children
Retrieving an identified Entity childrens.get
Entity Status
Set the status of an entity with entityId.put
Retrieving status of an identified Entity.get
Entity User
Deletion of a referenced user.delete
Referenced user retrieval.get
New user associated with an Entity.post
Users associated with an Entity.get
Entity User Status
Update user status .put
Referenced user status retrieval.get
Entity User Credentials
Resetting the user credentials.post
Modification of user credentials.post
Entity Metadata Type
Metadata deletion.delete
Modify an identified Metadata.put
Retrieve the metadata type.get
New metadata type associated with an Entity.post
Get all metadata type associated with an Entity.get
Entity ProfileData Type
ProfileData deletion.delete
Modify an identified ProfileData.put
Retrieve the ProfileData type.get
New ProfileData type associated with an Entity.post
Get all ProfileData type associated with an Entity.get

Wallets
Wallets
Creates a list of alias for a wallet.put
View Wallet Balanceget
View Wallet Entityget
Update a Walletpatch
View Wallet Informationget
Creating a wallet.post
Payment methods
Get paymentsMethodsget
Creates a wallet for a payment method.post
Transactions
View Wallet Specific Transactionget

Payment Methods
Payment method types
Retrieves a single payment method type and its attributes.get
Retrieves payment method types and their attributes.get
Payment methods
Creates a list of alias for a payment method.put
Deletes a payment method.delete
Returns the balance of a payment method.get
Payment methods links
It obtains wallet links for a specific payment method.get
Creates a link between a payment method and a wallet.post

Quotations
Quotations
Get a quotation.get
Creating a quotation.post

Transactions
Transactions
Get all enabled currenciesget
Creating a refundpost
Creating a disputepost
Creating an annulmentpost
Creating a reversalpost
Update a Transaction:patch
View a transactionget
Creating a transaction.post
Transactions Types
Add Transaction Subtypes for a given Typepost
Get all Transaction Subtypes for a given typeget
Get all Transaction Typesget
Metadatakeys
Delete a Transaction Metadata Keydelete
Add a Transaction Metadata Keyput
Get all Transaction Metadata Keysget

Hosted Checkout
Introduction
Checkout Request
Use the POST method to create a checkout page.post

Service Providers
Service Providers
View Service Providers Companiesget
View Products configurationget
View Pay Bill configurationget
Bills
Gets the bills using a payment reference for a specific billing company.get
Gets the bills using a payment reference for a specific billing company.get
Products
Obtains the products offfered by a Seller company.get
Obtains the products offfered by a Seller company.get

Issuing
Cards
Enable a printed digitalFirst card for POSput
Print a virtual card if the product is digitalFirstput
Set profile to a cardput
Unblock a Cardput
Block a card (it is reversible)put
Deactivate the card identified by cardReferenceput
Assign a physical card identified by cardReferenceput
Set a new CVV to a cardput
Reset Card PINpost
Assign Card PINput
Activcate the card identified by cardReferenceput
Patch a card datapatch
Retrieve a card object identified by cardReferenceget
returns a list of cards matching with the filtering criteria.get
Create a nominated cardpost
TenantProduct
Get all products of a tenantget
MCC
Retrieve a MCC category nameget
Retrieve a MCC category infoget
Get all MCC categoriesget
Tokenization
Delete a token of a cardpost
Unstop a token of a cardpost
Stop a token of a cardpost
Activate a token of a cardpost
List tokensget

Issuing - Tokenization Events (Client Side)
/tokenizationEvent
Tokenization events receptionput

Issuing - External Auth (client side)
External Authorization
Inform authorization updateput
Request authorization to clientpost

Giftcards API
Cards
Put Giftcard for card deactivationput
Put Giftcard for card activationput
Patch Giftcardpatch
Get Giftcard Info by IDget
Post Giftcardpost
Get Giftcard Info filtered listget

KYC (Know Your Customer)
Documents
Download A Documentget
Upload a documentpost
Faces
Download A face proof Documentget
Upload a photo or video as a face proofpost
Checks
Create a Checkpost
Reports
List Reports related to a Check Objectget
Retrieve a Report Objectget

SUBSCRIPTIONS API
Subscriptions
Get Subscription Info by IDget
Post Subscriptionpost
Get Subscription Info filtered listget
Payment
Manually creates or modifies a paymentput
Get payment dataget
Get payments by filtersget
PaymentAttempt
Retries a paymentpost
Get all payment attemptsget

Remittance API
Remittances
Refund a remittanceput
Cancels a remittancepost
Get a remittanceget
Get remittancesget
Create a remittancepost
Create a quotepost
Execute a quote previewpost
Catalogs
Get states for a specific countryget
Get payout methodsget
Get list of available countriesget
Get Payment Agent Branchesget
Get Payment Agent Regionsget
Get Payment Agent Account Typesget
Get Payment Agentsget

Recipients API
Recipients
Partially update recipient informationpatch
Delete recipient by IDdelete
Get recipient by IDget
Get all recipientsget
Create a new remittance recipientpost
Payout Methods
Partially update payout method information using JSON Patchpatch
Get a payout method by ID for a recipientdelete
Get a payout method by ID for a recipientget
Get all payout methods for a recipientget
Add a payout method for a recipientpost

VIRTUAL-ACCOUNTS API
VirtualAccounts
Patch VirtualAccountpatch
Delete VirtualAccountdelete
Get VirtualAccount Info by RequestReferenceget
Post VirtualAccountpost
Get VirtualAccount Info filtered listget

AccountValidator API
Account Validations
Initiate bank account ownership validationpost
Get the account validation data by id or correlation idget

200Represents a payment method type response.

400Represents an error caused by a business rule violation.

401Represents an error caused by an authorization failure.

404Represents an error caused by a failure to identify the target resource.

500Represents an error caused by a general server-side issue.

503Represents an error caused by system unavailability.