FNB-ALL-0001-A-110000

Generated -- do not edit by hand. Regenerate: acd build FNB-ALL-0001-A-110000

Contents

1. What Is This?
1. SKU Breakdown
1. Capabilities
1. Merchant Configuration
1. Configuration Details
Step 1: Group
Step 2: Merchant
Step 3: API User
Step 4: Terminal
Step 5: Terminal Config
Step 6: STS Token / Repository
Step 7: merchantPaymentGateway array
1. Open Items (3 fields)
1. See Also

1. What Is This?

Adyen Single Point of Failure (SPF) product code for Food & Beverage (Infrasys Complex) (FNB) in the ALL region.

Active payment methods: Bank Card + Token. No 3DS.

Default transaction flows: sale, void, refund, auth, capture, top_up

Business context: This SKU is intended for food-and-beverage merchants that require the Adyen SPF integration with bank-card and token capabilities.

Characteristics

Characteristic	Value
Architecture	SPF
3DS / MPI	No
Tokenization	Yes
Bank Card	Yes
Ecommerce (HPP)	No
QR Code	No
Gift Card	No
Partial Auth	Yes

2. SKU Breakdown

+-----+-----+------+----+--------+
| FNB | ALL | 0001 | A  | 110000 |
+-----+-----+------+----+--------+

Segment	Value	Meaning
Industry	`FNB`	Food & Beverage (Infrasys Complex) (reference)
Region	`ALL`	(reference)
Solution	`0001`	Adyen / SPF (reference)
Variant	`A`	(author meaning in reference/sku-naming.md)
Capabilities	`110000`	PM0, PM1 active (reference)

3. Capabilities

Payment Methods

PM Slot	Payment Method	Active
PM0	Bank Card	Yes
PM1	Token	Yes
PM2	QR MS	No
PM3	QR GS	No
PM4	Ecommerce	No
PM5	Gift	No
PM99	MPI / 3DS	No

4. Merchant Configuration

Configure the following MGMT objects in order. Each row = one API call.

Step	MGMT Object	Table	Required	Notes
1	Group	`group`	Y	Step 1
2	Merchant	`merchant`	Y	Step 2
3	API User	`apiuser`	Y	Step 3
4	Terminal	`terminal`	Y	Step 4
5	Terminal Config	`terminalConfig`	Y	Step 5
6	STS Token / Repository	`sts`	Y	Step 6
7	merchantPaymentGateway	`merchantPaymentGateway`	Y	[x] PM0 [x] PM1 [ ] PM2 [ ] PM3 [ ] PM4 [ ] PM5

Secret fields -- cells marked <secret> contain credentials or PII. Never commit actual values to source control. Supply via your secrets manager or provisioning vault.

5. Configuration Details

Columns: Key = provisioning identifier | MGMT Field = API body field name | Sample = UAT value (seed; verify before PROD) | Source = origin of the value

Step 1: Group (`group`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`GROUP_ID`	`groupId`	enum	Conditional	`1160` (default)	Group ID Lookup: `{{baseUrl}}/v1/group?aliasName={groupName}&groupName={groupName}&status=1`
`GROUP_NAME`	`groupName`	string	Conditional	--	Group name (also aliasName/comment)

Step 2: Merchant (`merchant`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`MERCHANT_NAME`	`merchantName`	string	Mandatory	--	Merchant display name
`REGION_ID`	`regionId`	enum	Mandatory	--	Region ID Allowed values: see Regions ref
`COUNTRY_CODE`	`countryCode`	enum	Mandatory	--	ISO country code Allowed values: see Countries ref Requires: REGION_ID
`CURRENCY_CODE`	`currencyCode`	enum	Conditional	`840` (default)	ISO numeric currency (e.g. 840 = USD, 978 = EUR) Allowed values: see Currency Codes ref
`BUSINESS_SYSTEM`	`bizSystemId`	enum	Conditional	--	Business system ID Allowed values: see Business Systems ref
`BILLING_METHOD`	`billingMethod`	enum	Conditional	`B04` (default)	Billing method Allowed values: see Billing Methods ref
`SERVICE_ENTRY`	`serviceEntry`	enum	Conditional	`1` (default)	[unconfirmed] Service entry mode (1 = ?, other values undocumented)
`ADDR`	`addr`	string	Conditional	`<secret>` (supply via secrets manager)	Address
`CITY`	`city`	string	Conditional	--	City
`STATE`	`state`	string	Conditional	--	State
`ADYEN_API_KEY`	`extData2`	string	Mandatory	`<secret>` (supply via secrets manager)	Adyen Master API Key (an alternate API key is also accepted)
`INDUSTRYTYPE`	`extData3`	enum	Conditional	`RESTAURANT` (default)	Industry type; falls back to RESTAURANT when empty Values: `LODGING`=Lodging industry profile / `RESTAURANT`=Restaurant/F&B profile / `RETAIL`=Retail profile
`ADYEN_HOST_MERCHANT_DNS`	`extData4`	url	Mandatory	`<secret>` (supply via secrets manager)	Host DNS. UAT/SIT: :// (no trailing slash/space). PROD: location/merchant PREFIX only, e.g. -
`ADYEN_TERMINAL_MERCHANT_DNS`	`extData5`	string	Conditional	`<secret>` (supply via secrets manager)	Terminal API DNS — applicable to Card Present only card present only
`ADYEN_HOST_MERCHANT_VERSION`	`extData6`	string	Mandatory	`V71` (default)	Adyen host/API version (e.g. V71)
`SMART_AUTH`	`extData7`	enum	Conditional	`FALSE` (default)	Smart Auth toggle Values: `TRUE`=Smart Auth enabled (must also be enabled in the Adyen portal) / `FALSE`=Smart Auth disabled
`ENABLE_ZIP_INPUT`	`extData8`	enum	Conditional	`FALSE` (default)	Enable ZIP input (ecom + SPF only) Values: `TRUE`=ZIP input enabled / `FALSE`=ZIP input disabled ecom only, SPF only
`LODGING_METADATA_ONLY`	`extData9`	enum	Conditional	`FALSE` (default)	Lodging metadata-only mode (Card Present only) Values: `TRUE`=Send only .metadata lodging fields / `FALSE`=Send full .lodging fields card present only
`SKU_STAMP`	`extData10`	string	Conditional	--	SKU stamp = merchant<->docs join key (reserved for SKU; currently UNWIRED)

Step 3: API User (`apiuser`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`API_USER`	`apiUserTemplate`	string	Conditional	--	API user — derived: MERCHANT without whitespace + xx (derived: MERCHANT name without whitespace + 'xx')

Step 4: Terminal (`terminal`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`TERMINAL_ID`	`terId`	string	Mandatory	--	Terminal ID (also workstationId)
`INTEGRATE_FLAG`	`integrateFlag`	string	Conditional	`NO` (default)	[unconfirmed] integrateFlag (sample NO; allowed values/meaning undocumented)
`TIPWORKFLOW_ENABLED`	`extData1`	enum	Conditional	--	Tip workflow enabled Values: `TRUE`=Tipping workflow enabled / `FALSE`=Disabled
`RENDERED`	`extData2`	enum	Conditional	--	RENDERED — receipt rendering Values: `TRUE`=Receipt rendering enabled / `FALSE`=Disabled
`SURCHARGE_ENABLED`	`extData3`	enum	Conditional	--	Surcharge enabled Values: `TRUE`=Surcharge enabled / `FALSE`=Disabled
`ALLOWPARTIAL`	`extData5`	enum	Conditional	--	Allow partial approvals Values: `TRUE`=Partial approvals allowed / `FALSE`=Not allowed
`SUPPRESS_ALT_PM`	`extData6`	enum	Conditional	`FALSE` (default)	Suppress alternative payment methods on Authorization (ecom only) Values: `TRUE`=Suppress alternative payment methods on auth / `FALSE`=Show them ecom only

Step 5: Terminal Config (`terminalConfig`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`ADYEN_MERCHANT_ACCOUNT`	`channelMerchantId`	string	Mandatory	`<secret>` (supply via secrets manager)	Adyen merchant account
`ADYEN_POIID`	`channelTerminalId`	string	Mandatory	`<secret>` (supply via secrets manager)	Adyen POIID (terminal identifier, e.g. -)
`HOST_TIMEOUT`	`extData1`	int	Conditional	`170000` (default)	Host timeout (ms)
`UNSUPPORTED_CARDTYPE_MAPPER`	`extData2`	string	Conditional	--	Unsupported card-type mapper (pre-auth). MS uses adyenUS
`CARD_TOKEN_TYPE`	`extData3`	enum	Conditional	`Standard` (default)	Card token type Values: `Extended`=Concatenate shopperReference + recurringDetailReference as the token returned to C2C / `Standard`=shopperReference returned as the token (default) / `OPI`=⚠ OPI mode — meaning not documented required for Card Present and Ecom HPP
`ADYEN_STORE`	`extData4`	string	Optional	--	Adyen store (partner platform integrations only)
`ADYEN_RECURRING_MODEL_OVERRIDE`	`extData5`	string	Optional	--	[unconfirmed] recurringProcessingModel override — purpose to confirm with Jakub

Step 6: STS Token / Repository (`sts`)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`STS_SPACE`	`spaceName`	string	Conditional	`mcli` (default)	Token space name
`STS_REPO`	`repositoryName`	string	Conditional	`mcli` (default)	Token repository name

Step 7: Merchant Payment Gateways (`merchantPaymentGateway`) -- Array

2 entries required. Provision in the order listed below.

Common fields (all entries)

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`GATEWAY_ID`	`gatewayId`	string	Conditional	`Tp2` (default)	Gateway ID (same across all MPG entries)
`STS_TOKEN_CHANNEL`	`STSTokenChannel`	string	Mandatory	`20559` (default)	STS token channel — needed for global token (card present) and MS alias-token flows

Entry 1 -- PM0 -- Bank Card

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`MAPPER_CP`	`extData2`	string	Mandatory	`ADYEN2.V2` (default)	Mapper for Bank Card MPG (SPF). In MS, this field is TTL to wait for webhook in ms (e.g. 160000)
`WAIT_FOR_WEBHOOK_CP`	`extData3`	enum	Mandatory	`TRUE` (default)	Wait-for-webhook toggle (PM0/PM1) Values: `TRUE`=Wait for webhook before responding / `FALSE`=Use gateway sync response

Entry 2 -- PM1 -- Token

Key	MGMT Field	Type	Required	Sample (UAT)	Notes
`MAPPER_TOKEN`	`extData2`	string	Mandatory	`ADYEN2.V2` (default)	Mapper for Token MPG (SPF). In MS, this field is TTL to wait for webhook in ms
`STS_TOKEN_CHANNEL_4`	`extData4`	string	Conditional	`20559` (default)	STS Token Channel (global-token / card-present flows)

6. Open Items -- Needs Sign-off

Fields marked confirm: true in the schema. Verify before production.

SERVICE_ENTRY / serviceEntry: Service entry mode (1 = ?, other values undocumented)
INTEGRATE_FLAG / integrateFlag: integrateFlag (sample NO; allowed values/meaning undocumented)
ADYEN_RECURRING_MODEL_OVERRIDE / extData5: recurringProcessingModel override — purpose to confirm with Jakub

7. See Also

Page metadata

| | | |:---|:---| | SKU | `FNB-ALL-0001-A-110000` | | Schema source | `schema/adyen.yaml` | | Values source | `values/` (see `_VALUES_MAP` in project.py) | | Generated by | `acd build FNB-