Documentation Index
Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
Use this file to discover all available pages before exploring further.
ACI Worldwide is a global payment systems provider that offers payment processing solutions for merchants and financial institutions. Their platform supports card payments with advanced features like delayed capture and international payment processing across multiple currencies and countries.
Credentials
When setting up ACI Worldwide in the dashboard, configure the
following credentials, which are obtained from ACI Worldwide merchant dashboard:
Entity ID
The entity required to authorize the request. This should be the channel entity
identifier. In case channel dispatching is activated then it should be the
merchant entity identifier.
Access token
The access token can be found under
Administration -> Account data -> Merchant / Channel Info
Base URL (optional)
The base URL to use for API requests. If no Base URL is provided then the
following defaults are used:
| Environment | Base URL |
|---|
| sandbox | https://eu-test.oppwa.com/ |
| production | https://eu-prod.oppwa.com/ |
Connector configuration
After setting up your ACI Worldwide connector in the dashboard, configure how transactions are routed to it. Choose one of the following options:
- Using Flow - Configure ACI Worldwide as the target connector in Flow to automatically route card transactions to this connector
- Using the API - Explicitly set the
payment_service_id parameter to the ACI Worldwide connector ID when creating transactions. This overrides any Flow routing rules.
The connector ID can be found in the dashboard under Connections -> Configured connections.
Features
ACI Worldwide supports the following features:
- Delayed capture - Authorize a payment and capture it at a later time
- Partial capture - Capture a portion of the authorized amount
- Partial refunds - Refund a portion of the captured amount
- Void - Cancel an authorized transaction before capture
- Zero auth - Verify a card without charging it
Supported countries
ACI Worldwide supports transactions from buyers in the following countries:
| Country code | Country code | Country code | Country code | Country code | Country code | Country code | Country code |
|---|
AT | AU | BE | BG | BR | CA | CH | CY |
CZ | DE | DK | EE | ES | FI | FR | GB |
GR | HK | HU | IE | IN | IT | JP | LT |
LU | LV | MT | MX | MY | NL | NO | NZ |
PL | PT | RO | SE | SG | SI | SK | US |
Supported currencies
ACI Worldwide supports processing payments in the following currencies:
| Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code |
|---|
AED | AFN | ALL | AMD | AOA | ARS | AUD | AWG |
AZN | BAM | BBD | BDT | BGN | BIF | BMD | BND |
BOB | BRL | BSD | BWP | BZD | CAD | CDF | CHF |
CLP | CNY | COP | CRC | CVE | CZK | DJF | DKK |
DOP | DZD | EGP | ETB | EUR | FJD | FKP | GBP |
GEL | GIP | GMD | GNF | GTQ | GYD | HKD | HNL |
HRK | HTG | HUF | IDR | ILS | INR | ISK | JMD |
JPY | KES | KGS | KHR | KMF | KRW | KYD | KZT |
LAK | LBP | LKR | LRD | LSL | MAD | MDL | MGA |
MKD | MMK | MNT | MOP | MUR | MVR | MWK | MXN |
MYR | MZN | NAD | NGN | NIO | NOK | NPR | NZD |
PAB | PEN | PGK | PHP | PKR | PLN | PYG | QAR |
RON | RSD | RUB | RWF | SAR | SBD | SCR | SEK |
SGD | SHP | SLL | SOS | SRD | SZL | THB | TJS |
TOP | TRY | TTD | TWD | TZS | UAH | UGX | USD |
UYU | UZS | VND | VUV | WST | XAF | XCD | XCG |
XOF | XPF | YER | ZAR | ZMW | | | |
Limitations
The following features are not supported by this connector:
- Over capture - Capturing more than the authorized amount
- Partial authorization - Accepting a partial amount when the full amount is not available
- Network tokens - Using network-level tokenization
- Digital wallets - Apple Pay, Google Pay, and other digital wallet integrations
- Payment method tokenization - Storing payment methods outside of transactions
Integration
To accept card payments with ACI Worldwide, you need to use one of Gr4vy’s client-side integration methods. Due to PCI compliance requirements, card data should never be sent directly to your servers.
You can integrate using:
- Embed - A pre-built, customizable payment form that handles the complete payment flow
- Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
- Mobile SDKs - Native SDKs for iOS, Android, React Native, and other platforms
After collecting the card details through one of these methods, the payment is processed through your configured ACI Worldwide connection.
Testing
For testing in sandbox environments, you can use standard test card numbers. ACI Worldwide supports industry-standard test cards for simulating different transaction scenarios:
Successful transactions:
- Visa:
4111 1111 1111 1111
- Mastercard:
5555 5555 5555 4444
- American Express:
3782 822463 10005
Use any future expiry date and any 3-digit CVV (4 digits for American Express).
For more test scenarios and additional card numbers, refer to the ACI Worldwide testing documentation or contact your ACI Worldwide representative.