Service

Service Nameamex

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]
AcquirerAcknowledgementModeTransactionLevel
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, BEL, BEN, BES, BGD, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BTN, BVT, BWA, CHE, CIV, COD, COK, CRI, CUW, CYP, CZE, 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, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, 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, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSP, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, TCA, 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, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STN, SVC, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW, ZWD]
IsGroupIdRequiredIndicates whether the payment engine is required to provide groupId or not in requests.
true

Protocol Specifications

IsOnlinetrue
ProtocolNameGlobal Credit Authorization Guide
ProtocolVersionOctober 2021
IsOnlinefalse
ProtocolNameGlobal Financial Submission Guide
ProtocolVersionOctober 2021

Security Checks

AddressVerificationCertified
ConfirmationCodeVerifiedCertified
CvcCheckCertified
OfflinePinCertified
OnlinePinCertified
ScaCertified
SignatureCertified
AmexSafekeyCertified
CbFranceNotSupported
CupSecurePlusNotSupported
DinersProtectBuyNotSupported
JcbJsecureNotSupported
MastercardSecureCodeNotSupported
VerifiedByVisaNotSupported

Submission Mode

ContactCertified
ContactLessCertified
ECommerceCertified
MagstripeCertified
MotoCertified
PkeCertified
TerminalCertified

Transaction Indicators

AirlineCertified
AirlineBspNotSupported
CarRentalDeveloped
CashbackNotSupported
CredentialOnFile[AdditionalCharge, DelayedCharge, Installment, NoShow, Reauthorisation, Recurring, Resubmission, Unscheduled]
DynamicCurrencyConversionAcceptorNotSupported
DynamicCurrencyConversionAcquirerNotSupported
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.
[ApplePay, GooglePay]
ExemptionsSupported 3DS Exemptions
[Corporate]
GamingNotSupported
HotelLodgingNotSupported
IssuerInstallmentsCertified
Level2DataCertified
Level3DataNotSupported
MerchantReferenceCertified
MerchantReferenceLength12
PaymentAccountReference
PaymentFacilitatorCertified
SoftDescriptorCertified
SoftDescriptorLength38
SurchargeNotSupported
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

AccountVerificationCertified
CashAdvanceNotSupported
FinalAuthorizationCertified
FullAuthorizationReversalCertified
FullCaptureCertified
FullRefundCertified
IncrementalAuthorizationCertified
MultiplePartialCaptureCertified
MultiplePartialRefundCertified
OriginalCreditCertified
PartialApprovalNotSupported
PartialAuthorizationReversalNotSupported
PartialCaptureCertified
PartialRefundCertified
PreAuthorizationCertified
RefundAuthorizationRequiredNotSupported
TechnicalReversalCertified

Operating Mode

DualFullOnlineNotSupported
DualOfflineCaptureCertified
SingleMessageOnlineNotSupported

Merchant Parameter

ParameterDescriptionApplicableOriginTypesMinMaxDefaultEnum ValuesValidationExpressionPrerequisitePrerequisiteInfoDistinctValuePerMid
paymentAggregatorNamePayment Service Provider (Aggregator) Name: This field must be populated when using Payment Aggregators and OptBlue Participants.XXXOptionalfalse
locationCategoryCodeLocation Category Code: This field must be populated for Oil Company Industry, including Card Acceptor Terminal (CAT) transactions where a single Service Establishment Number is not used for each physical location.[A-Z0-9]{1,83}Optionalfalse
merchantEmailMerchant/Seller Email: This field must be populated when using Payment Aggregators and OptBlue Participants.XXX@XXX.XXX^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}Optionalfalse
merchantTelephoneMerchant/Seller Telephone: This field must be populated when using Payment Aggregators and OptBlue Participants.00[0-9+][0-9]{1,19}Optionalfalse