Market specific variables
Market Specific Variables
This page provides country-specific configuration values and constraints for payment processing across Nordic markets.
Currency and Localization
- Currency:
NOK(Norwegian Krone) - Only local currency is supported - Language:
NB(Norwegian Bokmål) - If not provided, English will be used in the user interface - Country:
NO(mandatory field)
Remittance Information
Field: "remittanceInfo": "tshirt"
Limit: Max 140 characters
Description: Unstructured remittance information for payment description
Reference: "reference": "123451"
- Limit: Max 25 characters
- Type:
KID(Norwegian payment reference) - Issuer:
"referenceIssuer": "Company A"(Name of company issuing invoice)
Creditor Account
Supported Formats:
- IBAN: 15 characters, starting with NO followed by 13 digits
- BBAN: 11 digits
- Note: BIC, BGNR, PGNR are not applicable for this market
Example: "iban": "NO2390412263056" or "bban": "86011117947"
Currency and Localization
- Currency:
DKK(Danish Krone) - Only local currency is supported - Language:
DA(Danish) - If not provided, English will be used in the user interface - Country:
DK(mandatory field)
Remittance Information
Field: "remittanceInfo": "tshirt"
Limit: Max 140 characters
Description: Unstructured remittance information for payment description
Reference: "reference": "123451"
- Limit: 15 characters
- Type: Is not validated
- Issuer:
"referenceIssuer": "Company A"(Name of company issuing invoice)
Bank-specific limit: Lunar currently enforces a maximum of 20 characters for unstructured remittance information in the Danish market, overriding the standard 140-character limit above. See Bank-Specific Limits for details.
Creditor Account
Supported Formats:
- IBAN: 18 characters, starting with DK followed by 16 digits
- BBAN: 14 digits
- Note: BIC, BGNR, PGNR are not applicable for this market
Example: "iban": "DK5000400440116243" or "bban": "00400440116243"
Bank-Specific Limits
Some banks enforce stricter field limits than the standard market-level maximum. Always validate against the bank-specific limit when the creditor's bank is known, since exceeding it may cause the payment to be rejected.
| Bank | Field | Standard Limit | Bank-Specific Limit |
|---|---|---|---|
| Lunar | remittanceInfo | 140 characters | 20 characters |
Currency and Localization
- Currency:
EUR(Euro) - Only local currency is supported - Language:
FIorSV(Finnish or Swedish) - If not provided, English will be used in the user interface - Country:
FI(mandatory field)
Remittance Information
Field: "remittanceInfo": "tshirt"
Limit: Max 140 characters
Description: Unstructured remittance information for payment description
Reference: "reference": "123451"
- Limit: Max 20 characters
- Types:
INVOICE,SCOR,RF - Issuer:
"referenceIssuer": "Company A"(Name of company issuing invoice)
Creditor Account
Supported Formats:
- IBAN: 18 characters, starting with FI followed by 16 digits
- BBAN: 14 digits
- Note: BIC, BGNR, PGNR are not applicable for this market
Example: "iban": "FI2112345600000785" or "bban": "12345600000785"
Currency and Localization
- Currency:
SEK(Swedish Krona) - Only local currency is supported - Language:
SV(Swedish) - If not provided, English will be used in the user interface - Country:
SE(mandatory field)
Remittance Information
Field: "remittanceInfo": "tshirt"
Limits:
- Same day payment: Max 10 characters
- Scheduled payment: Max 12 characters
Description: Unstructured remittance information for payment description
Reference: "reference": "123451"
- Limit: 5-25 characters
- Type:
OCR(Only supported with Creditor Account BGNR/PGNR) - Issuer:
"referenceIssuer": "Company A"(Name of company issuing invoice)
Creditor Account
Standard Account Formats
IBAN: 24 characters, starting with SE followed by 22 digits
BBAN: 11 digits
BIC: Mandatory with BBAN
Important: BBAN + BIC payment option is not available for Skandia. Use IBAN instead.
Example: "iban": "SE4550000000058398257466" or "bban": "50000000058398257466"
Alternative Account Formats
BGNR or PGNR: Can be provided in place of IBAN or BBAN
- Restriction: Only works with scheduled payments
- Requirement: Must be accompanied by valid remittance OCR
Example: "bgnr": "1234567" or "pgnr": "1234567"
Implementation Notes
Account Information Priority
If the creditor account object is not provided, the information saved in the Merchant portal will be used. If the object is sent, at least one of IBAN or BBAN is required. When both are provided, IBAN takes priority.
Language Fallback
The language parameter allows for any value to be selected. If not provided, English will be used as the default user interface language across all markets.
Updated 12 days ago