Worldpay (Worldpay v1.0.0)

Copy Markdown View Source

Worldpay — Complete Elixir client for the Worldpay payment platform.

Covers all 45+ APIs: Access REST, WPG XML, cnpAPI, RAFT, Express, Marketplace, Payouts, FraudSight, 3DS, Tokens, and Reporting.

Module map

Access APIs (modern REST)

ModulePurpose
Worldpay.PaymentsOrchestrated Payments API
Worldpay.CardPaymentsModular Card Payments API
Worldpay.CardPayments.FeaturesAdvanced features: partial auth, AFT, L2/3, airline, MOTO, LatAm, ACP
Worldpay.APMs28 Alternative Payment Methods
Worldpay.ThreeDS3DS Authentication
Worldpay.FraudSightML fraud risk assessment
Worldpay.ExemptionsSCA exemption requests
Worldpay.TokensWorldpay tokens + NPTs + cryptograms
Worldpay.NetworkPaymentTokensCross-acquirer NPT management
Worldpay.CustomerEventServiceNPT lifecycle event webhooks
Worldpay.SecurityTokenServiceProvision / exchange / detokenize raw PANs
Worldpay.ForwardAPIPCI-scope-reducing proxy
Worldpay.TokenImportMigrate tokens from previous providers
Worldpay.CardPayoutsCard payouts (Fast Access ≤30 min)
Worldpay.AccountPayoutsBank account payouts
Worldpay.MoneyTransfersOCT money transfers
Worldpay.FXForeign exchange / MCP
Worldpay.AccountTransfersInternal account transfers
Worldpay.BalancesBalance enquiry
Worldpay.StatementsSettlement statements
Worldpay.PaymentQueriesQuery payment history
Worldpay.CardBINBIN lookup v1 + v2
Worldpay.VerificationsCard + BAV verification
Worldpay.AccountUpdaterAccount updater helpers
Worldpay.HPPHosted Payment Page + pay-by-link
Worldpay.Reporting.BatchTransactionsBatch Transaction API

Marketplace

ModulePurpose
Worldpay.Marketplaces.PartiesParty onboarding + KYC + beneficial owners
Worldpay.Marketplaces.SplitPaymentsSplit payments + split refunds

WPG (XML Gateway)

ModulePurpose
Worldpay.WPGWPG client + convenience wrappers
Worldpay.WPG.BuilderXML builders (Direct, HPP, 3DS2, split funding)
Worldpay.WPG.ParserXML → map parser
Worldpay.WPG.FeaturesDCC, Guaranteed Payments, Prime Routing, Lodging, MAC, JSC, etc.

cnpAPI (US eCommerce)

ModulePurpose
Worldpay.CNPcnpAPI REST client
Worldpay.CNP.BuilderXML builders
Worldpay.CNP.ParserXML → map parser

RAFT / In-Store

ModulePurpose
Worldpay.RAFTISO 8583 610 interface: all card-present types
Worldpay.RAFT.ResponseResponse field extractors
Worldpay.ExpressExpress Interface (lighter POS integration)

Partner

ModulePurpose
Worldpay.Partner.BoardingMerchant boarding API
Worldpay.Partner.LeadSubmissionLead submission to Salesforce
Worldpay.Partner.NotificationsTransaction notification parser
Worldpay.Partner.TerminalLeaseTerminal lease notification parser

Reporting

ModulePurpose
Worldpay.Reporting.EMAFeMAF daily settlement file parser
Worldpay.Reporting.BatchTransactionsBatch Transaction API
Worldpay.Reporting.CNPBatchcnpAPI batch file builder + completion parser

Infrastructure

ModulePurpose
Worldpay.WebhooksPayment lifecycle event parsing + dispatch
Worldpay.ConfigRuntime configuration
Worldpay.ErrorStructured error type
Worldpay.TelemetryTelemetry spans
Worldpay.ClientHTTP client (Req + Finch + circuit breaker)

Summary

Functions

authorize(instruction, config, opts \\ [])

Authorize via Payments API (orchestrated). See Worldpay.Payments.authorize/3.

cancel(payment_id, config, opts \\ [])

Cancel an authorization. See Worldpay.CardPayments.cancel/3.

config()

@spec config() :: Worldpay.Config.t()

Build a default Config.t() from application env.

events(payment_id, config)

Query payment events. See Worldpay.CardPayments.events/2.

partial_refund(payment_id, amount, currency, config, opts \\ [])

Partial refund. See Worldpay.CardPayments.partial_refund/5.

refund(payment_id, config, opts \\ [])

Full refund. See Worldpay.CardPayments.refund/3.

settle(payment_id, config, opts \\ [])

Settle a payment. See Worldpay.CardPayments.settle/3.

version()

@spec version() :: String.t()

Return the library version.