Service
| Service Name | worldline-bancontact |
Capabilities
| AcceptanceNetworksAn acceptance network is the payment card/- method/brand chosen by the card holder when initiating a transaction i.e. Visa, V Pay, Visa Electron, MasterCard, Maestro, Carte Bancaire, Bancontact, UnionPay, Amex, Diners, Discover, etc. Depending on the acceptance network chosen the transaction will be validated with linked scheme i.e. payment network linked to payment card. When setting up an Acquirer connection this connection will only be able to support the payment card/- method/brand's linked to the schemes with whom the Acquirer has certified. ⓘ | [AMEX, BLIK, Bancontact, Diners - Discover, Eftpos, JCB, Maestro, Mastercard, UPI, Union Pay, VISA - VISA Electron - Vpay] |
| AcquirerAcknowledgementMode | TransactionLevel |
| CountryCodesList of ISO country codes the connection supports (ISO 3166-1, Alpha-3 format). An empty list implies no restriction on supported countries. ⓘ | [ABW, AFG, AGO, AIA, ALA, ALB, AND, ARE, ARG, ARM, ASM, ATA, ATF, ATG, AUS, AUT, AZE, BDI, BEL, BEN, BES, BFA, BGD, BGR, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BRN, BTN, BVT, BWA, CAF, CAN, CCK, CHE, CHL, CHN, CIV, CMR, COD, COG, COK, COL, COM, CPV, CRI, CUB, CUW, CXR, CYM, CYP, CZE, DEU, DEU, DJI, DMA, DNK, DOM, DZA, ECU, EGY, ERI, ESH, ESP, EST, ETH, FIN, FJI, FLK, FRA, FRO, FSM, GAB, GBR, GEO, GGY, GHA, GIB, GIN, GLP, GMB, GNB, GNQ, GRC, GRD, GRL, GTM, GUF, GUM, GUY, HKG, HMD, HND, HRV, HTI, HUN, IDN, IMN, IND, IOT, IRL, IRN, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, KHM, KIR, KNA, KOR, KWT, LAO, LBN, LBR, LBY, LCA, LIE, LKA, LSO, LTU, LUX, LVA, MAC, MAF, MAR, MCO, MDA, MDG, MDV, MEX, MHL, MKD, MLI, MLT, MMR, MNE, MNG, MNP, MOZ, MRT, MSR, MTQ, MUS, MWI, MYS, MYT, NAM, NCL, NER, NFK, NGA, NIC, NIU, NLD, NOR, NPL, NRU, NZL, OMN, PAK, PAN, PCN, PER, PHL, PLW, PNG, POL, PRI, PRK, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSD, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, SYR, TCA, TCD, TGO, THA, TJK, TKL, TKM, TLS, TON, TTO, TUN, TUR, TUV, TWN, TZA, UGA, UKR, UMI, URY, USA, UZB, VAT, VCT, VEN, VGB, VIR, VNM, VUT, WLF, WSM, YEM, ZAF, ZMB, ZWE] |
| CurrencyListList of ISO currencies the connection supports (ISO 4217, Alpha-3 format). ⓘ | [AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VED, VES, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW, ZWL] |
| IsGroupIdRequiredIndicates whether the payment engine is required to provide groupId or not in requests. ⓘ | false |
Protocol Specifications
| IsOnline | true |
| ProtocolName | Nexo |
| ProtocolVersion | 6.0 |
Security Checks
| AddressVerification | Certified |
| ConfirmationCodeVerified | Certified |
| CvcCheck | Certified |
| OfflinePin | Certified |
| OnlinePin | Certified |
| Sca | |
| Signature | Certified |
| AmexSafekey | NotSupported |
| CbFrance | |
| CupSecurePlus | Certified |
| DinersProtectBuy | Certified |
| JcbJsecure | Certified |
| MastercardSecureCode | Certified |
| VerifiedByVisa | Certified |
Submission Mode
| Contact | Certified |
| ContactLess | Certified |
| ECommerce | Certified |
| Magstripe | Certified |
| Moto | Certified |
| Pke | Certified |
| Terminal | Certified |
Transaction Indicators
| Airline | Certified |
| AirlineBsp | NotSupported |
| CarRental | NotSupported |
| Cashback | Certified |
| CredentialOnFile | [DelayedCharge, NoShow, Reauthorisation, Recurring, Resubmission, Unscheduled, VariableRecurring] |
| DynamicCurrencyConversionAcceptor | Certified |
| DynamicCurrencyConversionAcquirer | Certified |
| DynamicCurrencyConversionProvidersService whereby international Visa and MasterCard Cardholders can choose to pay in their own currency, rather than the domestic currency of where they are making their purchase. This is known as Dynamic Currency Conversion (DCC) or eCommerce Dynamic Currency Conversion (eDCC). The list of the DCC providers. ⓘ | NotSupported |
| EWalletseWallets are digital wallets that securely stores your payment and shipping info. Typical providers are ApplePay and GooglePay. A transaction will be flagged as a eWallet transaction both in the authorisation and the capture. ⓘ | [AndroidPay, ApplePay] |
| ExemptionsSupported 3DS Exemptions ⓘ | [Corporate, DelegateAuthentication, LowAmount, LowRisk, WhiteListing] |
| Gaming | NotSupported |
| HotelLodging | NotSupported |
| IssuerInstallments | NotSupported |
| Level2Data | NotSupported |
| Level3Data | NotSupported |
| MerchantReference | Certified |
| MerchantReferenceLength | 35 |
| PaymentAccountReference | Developed |
| PaymentFacilitator | |
| SoftDescriptor | Developed |
| SoftDescriptorLength | 70 |
| Surcharge | |
| TokenizedProgramsThe tokenization is a process of replacing sensitive data with non-sensitive ones. It safeguards a card’s primary account number (PAN) by replacing it with a unique string of numbers called tokens. Worldline is offering a service called GTS that stores the customer’s card details, like the PAN, and generates tokens that merchants can use for payment transactions. For network tokenization, the card networks like Mastercard, Visa, and American Express, are the ones to store the PAN and generate the tokens. ⓘ | NotSupported |
Transaction Types
| AccountVerification | Certified |
| CashAdvance | Certified |
| FinalAuthorization | Certified |
| FullAuthorizationReversal | Certified |
| FullCapture | Certified |
| FullRefund | Certified |
| IncrementalAuthorization | Certified |
| MultiplePartialCapture | Certified |
| MultiplePartialRefund | Certified |
| OriginalCredit | Certified |
| PartialApproval | Certified |
| PartialAuthorizationReversal | Certified |
| PartialCapture | Certified |
| PartialRefund | Certified |
| PreAuthorization | Certified |
| RefundAuthorizationRequired | Certified |
| TechnicalReversal | Certified |
Operating Mode
| DualFullOnline | Certified |
| DualOfflineCapture | NotSupported |
| SingleMessageOnline | NotSupported |
Merchant Parameter
| Parameter | Description | ApplicableOriginTypes | Min | Max | Default | Enum Values | ValidationExpression | Prerequisite | PrerequisiteInfo | DistinctValuePerMid |
|---|---|---|---|---|---|---|---|---|---|---|
| bankCode | Identifier of the acquirer to target behind the processor, use regular api field instead MerchantData.acquirerIdentifier. | Optional | false | |||||||
| thresholdChargeback | Mass transit threshold chargeback field. | Optional | false | |||||||
| debtRecovery | Mass transit debt recovery field. | Optional | false |
Additional Data
| Parameter | Description | ApplicableOriginTypes | Min | Max | Default | Enum Values | ValidationExpression | Prerequisite | PrerequisiteInfo | DistinctValuePerMid |
|---|---|---|---|---|---|---|---|---|---|---|
| acceptorInstallment | This tag is to be set by the PE to indicate whether it's an acceptor installment or not. The possible values are: false (default value if not set) true | Optional | false | |||||||
| incidentCode | This tag is set by the payment engine to define the failure reason for the transaction (NEXO field FailureReason). | Optional | false | |||||||
| authenticationAmount | Authentication amount (deprecated, use cardHolder.data3D.authenticationAmount instead). | Optional | false | |||||||
| initiatingPartyID | Identifier that varies per requesting partner and acquirer. | Required | false |