PaymentMethod
PaymentMethod
Get list of all payment methods in flowRetail
Reference to a tenant uid
^[A-Za-z0-9-_]+PaymentMethod list response
GET /v2/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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 all payment methods available for tenant.
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
Reference to a system code
TenantPaymentMethod list response
GET /v2/tenants/{tenantUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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 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.
Reference to a tenant.
^[A-Za-z0-9-_]+Name of the payment method as it should be displayed on screen and receipts
A description of the payment method, shown in the client
^[A-Za-z0-9-_]+order of appearance in lists
Return a list of all paymentMethods in FlowRetail
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"
}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 paymentmethod details.
Reference to a tenant PaymentMethodUid.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Return a list of all paymentMethods in FlowRetail
GET /v2/tenants/{tenantUid}/paymentmethods/{tenantPaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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 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.
Reference to a tenant PaymentMethodUid.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+The name will be displayed in the clients and on the receipt
A description of the payment method, shown in the client
order of appearance in lists
Return a list of all paymentMethods in FlowRetail
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"
}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 list of payment methods for store.
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
StorePaymentMethod list response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Ledger number must be a valid number with possible leading zeros
| ENUM | Description |
|---|---|
| LEDGER | Ledger |
| GENERAL_LEDGER | General ledger |
| CUSTOMER_LEDGER | Customer ledger |
^[A-Za-z0-9-_]+^[A-Za-z0-9-_]+StorePaymentMethod response
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"
}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 details of a payment method for store
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a store PaymentMethodUid.
^[A-Za-z0-9-_]+StorePaymentMethod response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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
Update a payment method for a store
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a store PaymentMethodUid.
^[A-Za-z0-9-_]+Ledger number must be a valid number with possible leading zeros
| ENUM | Description |
|---|---|
| LEDGER | Ledger |
| GENERAL_LEDGER | General ledger |
| CUSTOMER_LEDGER | Customer ledger |
StorePaymentMethod response
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"
}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 list of issuers for a settlement on a store
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a store PaymentMethodUid.
^[A-Za-z0-9-_]+Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
StorePaymentMethodIssuer list response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
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 details of an issuer for a settlement on a store
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a store PaymentMethodUid.
^[A-Za-z0-9-_]+Reference to a store settlement issuerId.
^[A-Za-z0-9-_]+StorePaymentMethodIssuer response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/paymentmethods/{storePaymentMethodUid}/settlementissuers/{storeSettlementIssuerUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
StorePaymentMethodIssuer response
{
"code": "text",
"ledgerNumber": "text",
"ledgerType": "LEDGER",
"name": "text",
"storeSettlementIssuerUid": "text"
}Update details of an issuer for a settlement on a store
Update details of an issuer for a settlement on a store
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a store PaymentMethodUid.
^[A-Za-z0-9-_]+Reference to a store settlement issuerId.
^[A-Za-z0-9-_]+Ledger number must be a valid number with possible leading zeros
| ENUM | Description |
|---|---|
| LEDGER | Ledger |
| GENERAL_LEDGER | General ledger |
| CUSTOMER_LEDGER | Customer ledger |
StorePaymentMethodIssuer response
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"
}StorePaymentMethodIssuer response
{
"code": "text",
"ledgerNumber": "text",
"ledgerType": "LEDGER",
"name": "text",
"storeSettlementIssuerUid": "text"
}Was this helpful?