PaymentMethod

PaymentMethod

Get list of all payment methods available in Flow Retail

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/paymentmethods

Get list of all payment methods in flowRetail

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

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,
      "allowPrepayment": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    }
  ]
}

List tenant payment methods

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/paymentmethods

List all payment methods available for tenant.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

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",
      "receiptText": "text",
      "settlementCode": "text",
      "paymentMethod": {
        "allowRefund": true,
        "allowSale": true,
        "allowAmount": true,
        "allowCashback": true,
        "allowPrepayment": true,
        "requireExclusiveUse": true,
        "name": "text",
        "parameters": [
          {
            "key": "text",
            "keyType": "TEXT",
            "name": "text",
            "required": true
          }
        ],
        "paymentCode": "CASH"
      },
      "allowRefund": true,
      "tenantPaymentMethodUid": "text",
      "allowSale": true,
      "allowPrepayment": 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",
      "requirements": {
        "requireCustomer": true,
        "requireCustomerMobile": true,
        "requireCustomerEmail": true,
        "requireCustomerType": "ANY",
        "requireCustomerContact": true,
        "requireExclusiveUse": true,
        "requireRefundToSameMethod": true
      },
      "amountInput": "NONE",
      "useRounding": true
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Add a payment method to tenant

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/paymentmethods

Add a payment method to the tenant.

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

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

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

Body

application/json

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

receiptTextstring · max: 500Optional

Text printed on the receipt when this payment method is used (optional).

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

activebooleanRequired

namestringRequired

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

descriptionstringRequired

A description of the payment method, shown in the client

receiptTextstring · max: 500Required

Text printed on the receipt when this payment method is used. Empty when not configured.

settlementCodestringRequired

allowRefundbooleanRequired

if true, paymentMethod can be used when settling a refund.

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

allowSalebooleanRequired

if true, paymentMethod can be used when settling a sale.

allowPrepaymentbooleanRequired

if true, paymentMethod can be used when settling a sale.

allowCashbackbooleanRequired

if true, settlement amount can be higher than remainingAmount when settling a sale.

positionintegerRequired

order of appearance in lists

visibilitystring · enumRequiredPossible values:

amountInputstring · enumRequiredPossible values:

useRoundingbooleanRequired

post/tenants/{tenantUid}/paymentmethods

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: 191

{
  "active": true,
  "name": "text",
  "description": "text",
  "receiptText": "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",
  "receiptText": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "allowPrepayment": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "allowRefund": true,
  "tenantPaymentMethodUid": "text",
  "allowSale": true,
  "allowPrepayment": 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",
  "requirements": {
    "requireCustomer": true,
    "requireCustomerMobile": true,
    "requireCustomerEmail": true,
    "requireCustomerType": "ANY",
    "requireCustomerContact": true,
    "requireExclusiveUse": true,
    "requireRefundToSameMethod": true
  },
  "amountInput": "NONE",
  "useRounding": true
}

Get tenant paymentmethod details

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Get paymentmethod details.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

activebooleanRequired

namestringRequired

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

descriptionstringRequired

A description of the payment method, shown in the client

receiptTextstring · max: 500Required

Text printed on the receipt when this payment method is used. Empty when not configured.

settlementCodestringRequired

allowRefundbooleanRequired

if true, paymentMethod can be used when settling a refund.

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

allowSalebooleanRequired

if true, paymentMethod can be used when settling a sale.

allowPrepaymentbooleanRequired

if true, paymentMethod can be used when settling a sale.

allowCashbackbooleanRequired

if true, settlement amount can be higher than remainingAmount when settling a sale.

positionintegerRequired

order of appearance in lists

visibilitystring · enumRequiredPossible values:

amountInputstring · enumRequiredPossible values:

useRoundingbooleanRequired

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

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",
  "receiptText": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "allowPrepayment": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "allowRefund": true,
  "tenantPaymentMethodUid": "text",
  "allowSale": true,
  "allowPrepayment": 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",
  "requirements": {
    "requireCustomer": true,
    "requireCustomerMobile": true,
    "requireCustomerEmail": true,
    "requireCustomerType": "ANY",
    "requireCustomerContact": true,
    "requireExclusiveUse": true,
    "requireRefundToSameMethod": true
  },
  "amountInput": "NONE",
  "useRounding": true
}

Update paymentmethods details

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Update paymentmethod details for tenant.

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

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

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

application/json

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

receiptTextstring · max: 500Optional

Text printed on the receipt when this payment method is used. Omit to leave unchanged.

allowSalebooleanOptional

allowRefundbooleanOptional

allowCashbackbooleanOptional

allowPrepaymentbooleanOptional

settlementCodestringOptional

positionintegerOptional

order of appearance in lists

visibilitystring · enumOptionalPossible values:

amountInputstring · enumOptionalPossible values:

useRoundingbooleanOptional

requireCustomerbooleanOptional

requireCustomerMobilebooleanOptional

requireCustomerEmailbooleanOptional

requireCustomerTypestring · enumOptionalPossible values:

requireCustomerContactbooleanOptional

requireRefundToSameMethodbooleanOptional

requireExclusiveUsebooleanOptional

Responses

200

Return a list of all paymentMethods in FlowRetail

application/json

activebooleanRequired

namestringRequired

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

descriptionstringRequired

A description of the payment method, shown in the client

receiptTextstring · max: 500Required

Text printed on the receipt when this payment method is used. Empty when not configured.

settlementCodestringRequired

allowRefundbooleanRequired

if true, paymentMethod can be used when settling a refund.

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

allowSalebooleanRequired

if true, paymentMethod can be used when settling a sale.

allowPrepaymentbooleanRequired

if true, paymentMethod can be used when settling a sale.

allowCashbackbooleanRequired

if true, settlement amount can be higher than remainingAmount when settling a sale.

positionintegerRequired

order of appearance in lists

visibilitystring · enumRequiredPossible values:

amountInputstring · enumRequiredPossible values:

useRoundingbooleanRequired

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

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: 450

{
  "active": true,
  "name": "text",
  "description": "text",
  "receiptText": "text",
  "allowSale": true,
  "allowRefund": true,
  "allowCashback": true,
  "allowPrepayment": true,
  "settlementCode": "text",
  "position": 1,
  "visibility": "FEATURED",
  "amountInput": "NONE",
  "useRounding": true,
  "requireCustomer": true,
  "requireCustomerMobile": true,
  "requireCustomerEmail": true,
  "requireCustomerType": "ANY",
  "requireCustomerContact": true,
  "requireRefundToSameMethod": true,
  "requireExclusiveUse": true
}

200

Return a list of all paymentMethods in FlowRetail

{
  "active": true,
  "name": "text",
  "description": "text",
  "receiptText": "text",
  "settlementCode": "text",
  "paymentMethod": {
    "allowRefund": true,
    "allowSale": true,
    "allowAmount": true,
    "allowCashback": true,
    "allowPrepayment": true,
    "requireExclusiveUse": true,
    "name": "text",
    "parameters": [
      {
        "key": "text",
        "keyType": "TEXT",
        "name": "text",
        "required": true
      }
    ],
    "paymentCode": "CASH"
  },
  "allowRefund": true,
  "tenantPaymentMethodUid": "text",
  "allowSale": true,
  "allowPrepayment": 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",
  "requirements": {
    "requireCustomer": true,
    "requireCustomerMobile": true,
    "requireCustomerEmail": true,
    "requireCustomerType": "ANY",
    "requireCustomerContact": true,
    "requireExclusiveUse": true,
    "requireRefundToSameMethod": true
  },
  "amountInput": "NONE",
  "useRounding": true
}

List store payment methods

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Get list of payment methods for store.

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

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",
        "receiptText": "text",
        "settlementCode": "text",
        "paymentMethod": {
          "allowRefund": true,
          "allowSale": true,
          "allowAmount": true,
          "allowCashback": true,
          "allowPrepayment": true,
          "requireExclusiveUse": true,
          "name": "text",
          "parameters": [
            {
              "key": "text",
              "keyType": "TEXT",
              "name": "text",
              "required": true
            }
          ],
          "paymentCode": "CASH"
        },
        "allowRefund": true,
        "tenantPaymentMethodUid": "text",
        "allowSale": true,
        "allowPrepayment": 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",
        "requirements": {
          "requireCustomer": true,
          "requireCustomerMobile": true,
          "requireCustomerEmail": true,
          "requireCustomerType": "ANY",
          "requireCustomerContact": true,
          "requireExclusiveUse": true,
          "requireRefundToSameMethod": true
        },
        "amountInput": "NONE",
        "useRounding": true
      }
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Add a payment method to a store

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Add a payment method to a store

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

application/json

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

activebooleanRequired

ledgerNumberstringRequired

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumRequired

ENUM	Description
LEDGER	Ledger
GENERAL_LEDGER	General ledger
CUSTOMER_LEDGER	Customer ledger

Possible values:

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

storeSettlementIssuersbooleanRequired

Bool indication there are storeSettlementIssuer records on this storePaymentMethod

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

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",
    "receiptText": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "allowPrepayment": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "allowRefund": true,
    "tenantPaymentMethodUid": "text",
    "allowSale": true,
    "allowPrepayment": 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",
    "requirements": {
      "requireCustomer": true,
      "requireCustomerMobile": true,
      "requireCustomerEmail": true,
      "requireCustomerType": "ANY",
      "requireCustomerContact": true,
      "requireExclusiveUse": true,
      "requireRefundToSameMethod": true
    },
    "amountInput": "NONE",
    "useRounding": true
  }
}

Get details of a payment method for store

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Get details of a payment method for store

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

activebooleanRequired

ledgerNumberstringRequired

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumRequired

ENUM	Description
LEDGER	Ledger
GENERAL_LEDGER	General ledger
CUSTOMER_LEDGER	Customer ledger

Possible values:

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

storeSettlementIssuersbooleanRequired

Bool indication there are storeSettlementIssuer records on this storePaymentMethod

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

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",
    "receiptText": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "allowPrepayment": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "allowRefund": true,
    "tenantPaymentMethodUid": "text",
    "allowSale": true,
    "allowPrepayment": 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",
    "requirements": {
      "requireCustomer": true,
      "requireCustomerMobile": true,
      "requireCustomerEmail": true,
      "requireCustomerType": "ANY",
      "requireCustomerContact": true,
      "requireExclusiveUse": true,
      "requireRefundToSameMethod": true
    },
    "amountInput": "NONE",
    "useRounding": true
  }
}

Update a payment method for a store

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Update a payment method for a store

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

application/json

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

activebooleanRequired

ledgerNumberstringRequired

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumRequired

ENUM	Description
LEDGER	Ledger
GENERAL_LEDGER	General ledger
CUSTOMER_LEDGER	Customer ledger

Possible values:

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

storeSettlementIssuersbooleanRequired

Bool indication there are storeSettlementIssuer records on this storePaymentMethod

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

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",
    "receiptText": "text",
    "settlementCode": "text",
    "paymentMethod": {
      "allowRefund": true,
      "allowSale": true,
      "allowAmount": true,
      "allowCashback": true,
      "allowPrepayment": true,
      "requireExclusiveUse": true,
      "name": "text",
      "parameters": [
        {
          "key": "text",
          "keyType": "TEXT",
          "name": "text",
          "required": true
        }
      ],
      "paymentCode": "CASH"
    },
    "allowRefund": true,
    "tenantPaymentMethodUid": "text",
    "allowSale": true,
    "allowPrepayment": 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",
    "requirements": {
      "requireCustomer": true,
      "requireCustomerMobile": true,
      "requireCustomerEmail": true,
      "requireCustomerType": "ANY",
      "requireCustomerContact": true,
      "requireExclusiveUse": true,
      "requireRefundToSameMethod": true
    },
    "amountInput": "NONE",
    "useRounding": true
  }
}

Get list of issuers for a settlement on a store

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Get list of issuers for a settlement on a store

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Get details of an issuer for a settlement on a store

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

codestringRequired

ledgerNumberstringRequired

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumRequired

ENUM	Description
LEDGER	Ledger
GENERAL_LEDGER	General ledger
CUSTOMER_LEDGER	Customer ledger

Possible values:

namestringRequired

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

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

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

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

Update details of an issuer for a settlement on a store

Required permissions: PAYMENT_METHOD

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Access token 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

application/json

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

codestringRequired

ledgerNumberstringRequired

Ledger number must be a valid number with possible leading zeros

ledgerTypestring · enumRequired

ENUM	Description
LEDGER	Ledger
GENERAL_LEDGER	General ledger
CUSTOMER_LEDGER	Customer ledger

Possible values:

namestringRequired

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

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

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"
}