PaymentMethod

PaymentMethod

Get list of all payment methods available in Flow Retail

get

Get list of all payment methods in flowRetail

Authorizations

accessTokenauthTokenintegrationToken

Query parameters

tenantUidstringoptional

Reference to a tenant uid

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

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

PaymentMethod list response

{
  "items": [
    {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    }
  ]
}

List tenant payment methods

get

List all payment methods available for tenant.

Authorizations

accessTokenauthTokenintegrationToken

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

Available options:

visibilitystring · enum[]optional

Filter by visibility

systemCodestring · enumoptional

Reference to a system code

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

TenantPaymentMethod list response

{
  "items": [
    {
      "active": true,
      "name": "text",
      "description": "text",
      "settlementCode": "text",
      "paymentMethod": {
        "allowRefund": true,
        "allowSale": true,
        "allowAmount": true,
        "allowCashback": true,
        "requireExclusiveUse": true,
        "name": "text",
        "parameters": [
          {
            "key": "text",
            "keyType": "TEXT",
            "name": "text",
            "required": true
          }
        ],
        "paymentCode": "CASH"
      },
      "tenantPaymentMethodUid": "text",
      "allowRefund": true,
      "allowSale": true,
      "allowCashback": true,
      "parameters": [
        {
          "name": "text",
          "description": "text",
          "required": true,
          "key": "text",
          "type": "TEXT",
          "regex": "text"
        }
      ],
      "externalSystemMappings": [
        {
          "systemCode": "OMNIUM",
          "externalId": "text",
          "tenantPaymentMethodMappingUid": "text"
        }
      ],
      "position": 1,
      "visibility": "FEATURED"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Add a payment method to tenant

post

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

accessTokenauthTokenintegrationToken

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 · enumrequiredAvailable options:

positionintegerrequired

order of appearance in lists

visibilitystring · enumrequiredAvailable options:

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 170

{
  "active": true,
  "name": "text",
  "description": "text",
  "tenantPaymentMethodUid": "text",
  "settlementCode": "text",
  "paymentMethodCode": "CASH",
  "position": 1,
  "visibility": "FEATURED"
}

200

Return a list of all paymentMethods in FlowRetail

{
  "active": true,
  "name": "text",
  "description": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "tenantPaymentMethodUid": "text",
  "allowRefund": true,
  "allowSale": true,
  "allowCashback": true,
  "parameters": [
    {
      "name": "text",
      "description": "text",
      "required": true,
      "key": "text",
      "type": "TEXT",
      "regex": "text"
    }
  ],
  "externalSystemMappings": [
    {
      "systemCode": "OMNIUM",
      "externalId": "text",
      "tenantPaymentMethodMappingUid": "text"
    }
  ],
  "position": 1,
  "visibility": "FEATURED"
}

Get tenant paymentmethod details

get

Get paymentmethod details.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantPaymentMethodUidstringrequired

Reference to a tenant PaymentMethodUid.

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

tenantUidstringrequired

Reference to a tenant.

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

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Return a list of all paymentMethods in FlowRetail

{
  "active": true,
  "name": "text",
  "description": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "tenantPaymentMethodUid": "text",
  "allowRefund": true,
  "allowSale": true,
  "allowCashback": true,
  "parameters": [
    {
      "name": "text",
      "description": "text",
      "required": true,
      "key": "text",
      "type": "TEXT",
      "regex": "text"
    }
  ],
  "externalSystemMappings": [
    {
      "systemCode": "OMNIUM",
      "externalId": "text",
      "tenantPaymentMethodMappingUid": "text"
    }
  ],
  "position": 1,
  "visibility": "FEATURED"
}

Update paymentmethods details

put

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

accessTokenauthTokenintegrationToken

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 · enumoptionalAvailable options:

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "active": true,
  "name": "text",
  "description": "text",
  "allowSale": true,
  "allowRefund": true,
  "allowCashback": true,
  "settlementCode": "text",
  "position": 1,
  "visibility": "FEATURED"
}

200

Return a list of all paymentMethods in FlowRetail

{
  "active": true,
  "name": "text",
  "description": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "tenantPaymentMethodUid": "text",
  "allowRefund": true,
  "allowSale": true,
  "allowCashback": true,
  "parameters": [
    {
      "name": "text",
      "description": "text",
      "required": true,
      "key": "text",
      "type": "TEXT",
      "regex": "text"
    }
  ],
  "externalSystemMappings": [
    {
      "systemCode": "OMNIUM",
      "externalId": "text",
      "tenantPaymentMethodMappingUid": "text"
    }
  ],
  "position": 1,
  "visibility": "FEATURED"
}

List store payment methods

get

Get list of payment methods for store.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

storeUidstringrequired

Reference to a Store.

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

Query parameters

storePaymentMethodCodestring · enum[]optional

Reference to a payment method code

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

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

StorePaymentMethod list response

{
  "items": [
    {
      "active": true,
      "ledgerNumber": "text",
      "ledgerType": "LEDGER",
      "storePaymentMethodUid": "text",
      "storeSettlementIssuers": true,
      "tenantPaymentMethod": {
        "active": true,
        "name": "text",
        "description": "text",
        "settlementCode": "text",
        "paymentMethod": {
          "allowRefund": true,
          "allowSale": true,
          "allowAmount": true,
          "allowCashback": true,
          "requireExclusiveUse": true,
          "name": "text",
          "parameters": [
            {
              "key": "text",
              "keyType": "TEXT",
              "name": "text",
              "required": true
            }
          ],
          "paymentCode": "CASH"
        },
        "tenantPaymentMethodUid": "text",
        "allowRefund": true,
        "allowSale": true,
        "allowCashback": true,
        "parameters": [
          {
            "name": "text",
            "description": "text",
            "required": true,
            "key": "text",
            "type": "TEXT",
            "regex": "text"
          }
        ],
        "externalSystemMappings": [
          {
            "systemCode": "OMNIUM",
            "externalId": "text",
            "tenantPaymentMethodMappingUid": "text"
          }
        ],
        "position": 1,
        "visibility": "FEATURED"
      }
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Add a payment method to a store

post

Add a payment method to a store

Authorizations

accessTokenauthTokenintegrationToken

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

Available options:

tenantPaymentMethodUidstringrequiredPattern: ^[A-Za-z0-9-_]+

storePaymentMethodUidstringoptionalPattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "active": true,
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "tenantPaymentMethodUid": "text",
  "storePaymentMethodUid": "text"
}

200

StorePaymentMethod response

{
  "active": true,
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "storePaymentMethodUid": "text",
  "storeSettlementIssuers": true,
  "tenantPaymentMethod": {
    "active": true,
    "name": "text",
    "description": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "tenantPaymentMethodUid": "text",
    "allowRefund": true,
    "allowSale": true,
    "allowCashback": true,
    "parameters": [
      {
        "name": "text",
        "description": "text",
        "required": true,
        "key": "text",
        "type": "TEXT",
        "regex": "text"
      }
    ],
    "externalSystemMappings": [
      {
        "systemCode": "OMNIUM",
        "externalId": "text",
        "tenantPaymentMethodMappingUid": "text"
      }
    ],
    "position": 1,
    "visibility": "FEATURED"
  }
}

Get details of a payment method for store

get

Get details of a payment method for store

Authorizations

accessTokenauthTokenintegrationToken

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

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

StorePaymentMethod response

{
  "active": true,
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "storePaymentMethodUid": "text",
  "storeSettlementIssuers": true,
  "tenantPaymentMethod": {
    "active": true,
    "name": "text",
    "description": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "tenantPaymentMethodUid": "text",
    "allowRefund": true,
    "allowSale": true,
    "allowCashback": true,
    "parameters": [
      {
        "name": "text",
        "description": "text",
        "required": true,
        "key": "text",
        "type": "TEXT",
        "regex": "text"
      }
    ],
    "externalSystemMappings": [
      {
        "systemCode": "OMNIUM",
        "externalId": "text",
        "tenantPaymentMethodMappingUid": "text"
      }
    ],
    "position": 1,
    "visibility": "FEATURED"
  }
}

Update a payment method for a store

put

Update a payment method for a store

Authorizations

accessTokenauthTokenintegrationToken

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

Available options:

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "active": true,
  "ledgerNumber": "text",
  "ledgerType": "LEDGER"
}

200

StorePaymentMethod response

{
  "active": true,
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "storePaymentMethodUid": "text",
  "storeSettlementIssuers": true,
  "tenantPaymentMethod": {
    "active": true,
    "name": "text",
    "description": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "tenantPaymentMethodUid": "text",
    "allowRefund": true,
    "allowSale": true,
    "allowCashback": true,
    "parameters": [
      {
        "name": "text",
        "description": "text",
        "required": true,
        "key": "text",
        "type": "TEXT",
        "regex": "text"
      }
    ],
    "externalSystemMappings": [
      {
        "systemCode": "OMNIUM",
        "externalId": "text",
        "tenantPaymentMethodMappingUid": "text"
      }
    ],
    "position": 1,
    "visibility": "FEATURED"
  }
}

Get list of issuers for a settlement on a store

get

Get list of issuers for a settlement on a store

Authorizations

accessTokenauthTokenintegrationToken

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

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

StorePaymentMethodIssuer list response

{
  "items": [
    {
      "code": "text",
      "ledgerNumber": "text",
      "ledgerType": "LEDGER",
      "name": "text",
      "storeSettlementIssuerUid": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Get details of an issuer for a settlement on a store

get

Get details of an issuer for a settlement on a store

Authorizations

accessTokenauthTokenintegrationToken

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

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

StorePaymentMethodIssuer response

{
  "code": "text",
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "name": "text",
  "storeSettlementIssuerUid": "text"
}

Update details of an issuer for a settlement on a store

put

Update details of an issuer for a settlement on a store

Authorizations

accessTokenauthTokenintegrationToken

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

Available options:

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "ledgerNumber": "text",
  "ledgerType": "LEDGER"
}

200

StorePaymentMethodIssuer response

{
  "code": "text",
  "ledgerNumber": "text",
  "ledgerType": "LEDGER",
  "name": "text",
  "storeSettlementIssuerUid": "text"
}