Heads up, our devs are blazing ahead—docs are catching up, so some features might not be fully documented yet.

PaymentMethod

PaymentMethod

Get list of all payment methods available in Flow Retail

get
/paymentmethods

Get list of all payment methods in flowRetail

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Query parameters
tenantUidstringOptional

Reference to a tenant uid

Pattern: ^[A-Za-z0-9-_]+
Responses
200

PaymentMethod list response

application/json
get
/paymentmethods
200

PaymentMethod list response

List tenant payment methods

get
/tenants/{tenantUid}/paymentmethods

List all payment methods available for tenant.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
systemCodestring · enumOptional

Reference to a system code

Possible values:
Responses
200

TenantPaymentMethod list response

application/json
get
/tenants/{tenantUid}/paymentmethods
200

TenantPaymentMethod list response

Add a payment method to tenant

post
/tenants/{tenantUid}/paymentmethods

Add a payment method to the tenant.

For external payment methods, settlementCode is required. It must have the prefixEXTERNAL_.

For all other payment methods, the payment code is used as the settlement code.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
activebooleanOptional
namestringOptional

Name of the payment method as it should be displayed on screen and receipts

descriptionstringOptional

A description of the payment method, shown in the client

tenantPaymentMethodUidstringOptionalPattern: ^[A-Za-z0-9-_]+
settlementCodestringOptional
paymentMethodCodestring · enumRequiredPossible values:
positionintegerRequired

order of appearance in lists

visibilitystring · enumRequiredPossible values:
Responses
200

Return a list of all paymentMethods in FlowRetail

application/json
post
/tenants/{tenantUid}/paymentmethods
200

Return a list of all paymentMethods in FlowRetail

Get tenant paymentmethod details

get
/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid}

Get paymentmethod details.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantPaymentMethodUidstringRequired

Reference to a tenant PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Return a list of all paymentMethods in FlowRetail

application/json
get
/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid}
200

Return a list of all paymentMethods in FlowRetail

Update paymentmethods details

put
/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid}

Update paymentmethod details for tenant.

settlementCode can only be set and updated for EXTERNAL payment methods. It must have the prefixEXTERNAL_.

For all other payment methods, the payment code is used as the settlement code.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantPaymentMethodUidstringRequired

Reference to a tenant PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Body
activebooleanOptional
namestringOptional

The name will be displayed in the clients and on the receipt

descriptionstringOptional

A description of the payment method, shown in the client

allowSalebooleanOptional
allowRefundbooleanOptional
allowCashbackbooleanOptional
settlementCodestringOptional
positionintegerOptional

order of appearance in lists

visibilitystring · enumOptionalPossible values:
Responses
200

Return a list of all paymentMethods in FlowRetail

application/json
put
/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid}
200

Return a list of all paymentMethods in FlowRetail

List store payment methods

get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods

Get list of payment methods for store.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

StorePaymentMethod list response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods
200

StorePaymentMethod list response

Add a payment method to a store

post
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods

Add a payment method to a store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body
activebooleanOptional
ledgerNumberstringOptional

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumOptional
ENUM Description
LEDGER Ledger
GENERAL_LEDGER General ledger
CUSTOMER_LEDGER Customer ledger
Possible values:
tenantPaymentMethodUidstringRequiredPattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
200

StorePaymentMethod response

application/json
post
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods
200

StorePaymentMethod response

Get details of a payment method for store

get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}

Get details of a payment method for store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringRequired

Reference to a store PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

StorePaymentMethod response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}
200

StorePaymentMethod response

Update a payment method for a store

put
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}

Update a payment method for a store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringRequired

Reference to a store PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
Body
activebooleanOptional
ledgerNumberstringOptional

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumOptional
ENUM Description
LEDGER Ledger
GENERAL_LEDGER General ledger
CUSTOMER_LEDGER Customer ledger
Possible values:
Responses
200

StorePaymentMethod response

application/json
put
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}
200

StorePaymentMethod response

Get list of issuers for a settlement on a store

get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers

Get list of issuers for a settlement on a store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringRequired

Reference to a store PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

StorePaymentMethodIssuer list response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers
200

StorePaymentMethodIssuer list response

Get details of an issuer for a settlement on a store

get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid}

Get details of an issuer for a settlement on a store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringRequired

Reference to a store PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
storeSettlementIssuerUidstringRequired

Reference to a store settlement issuerId.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

StorePaymentMethodIssuer response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid}
200

StorePaymentMethodIssuer response

Update details of an issuer for a settlement on a store

put
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid}

Update details of an issuer for a settlement on a store

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
storePaymentMethodUidstringRequired

Reference to a store PaymentMethodUid.

Pattern: ^[A-Za-z0-9-_]+
storeSettlementIssuerUidstringRequired

Reference to a store settlement issuerId.

Pattern: ^[A-Za-z0-9-_]+
Body
ledgerNumberstringOptional

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumOptional
ENUM Description
LEDGER Ledger
GENERAL_LEDGER General ledger
CUSTOMER_LEDGER Customer ledger
Possible values:
Responses
200

StorePaymentMethodIssuer response

application/json
put
/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid}
200

StorePaymentMethodIssuer response

Last updated

Was this helpful?