> ## 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. # Powertranz - Card > Connect to Powertranz to accept credit and debit card payments. export const connector = { displayName: "Powertranz", method: "card", features: "create_token create_transaction delayed_capture direct_integration_create partial_capture partial_refunds payment_method_tokenization refunds three_d_secure_hosted verify_credentials void zero_auth", supportedCountries: "AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS XK YE YT ZA ZM ZW", supportedCurrencies: "AED AFN ALL AMD AOA ARS AUD AWG AZN BAM BBD BDT BHD BIF BMD BND BOB BOV BRL BSD BTN BWP BYN BZD CAD CDF CHE CHF CHW CLF CLP CNY COP COU CRC CUP CVE CZK DJF DKK DOP DZD EGP ERN ETB EUR FJD FKP GBP GEL GHS GIP GMD GNF GTQ GYD HKD HNL 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 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 XCG XOF XPF YER ZAR ZMW ZWG" }; export const ConnectorRegions = ({data, kind, name: nameOverride}) => { const [query, setQuery] = useState(""); const [open, setOpen] = useState(false); const isCountries = kind === "countries"; const raw = data && (isCountries ? data.supportedCountries : data.supportedCurrencies); const codes = typeof raw === "string" ? raw.split(/\s+/).filter(Boolean) : Array.isArray(raw) ? raw : []; const DISPLAY_NAME_OVERRIDES = { authorizenet: "Authorize.net", cardpointe: "Fiserv CardPointe", dlocal: "dLocal", shift4i4go: "Shift4 i4go", tokenex: "TokenEx" }; const rawName = data && data.displayName || ""; const name = nameOverride || DISPLAY_NAME_OVERRIDES[rawName.toLowerCase()] || rawName || "This connector"; const verb = isCountries ? "supports transactions from buyers in" : "supports processing payments in"; const noun = isCountries ? "countries" : "currencies"; if (codes.length === 0) return null; let displayNames = null; try { displayNames = new Intl.DisplayNames(["en"], { type: isCountries ? "region" : "currency" }); } catch (e) { displayNames = null; } const resolve = code => { if (!displayNames) return null; try { const resolved = displayNames.of(code); return resolved && resolved !== code ? resolved : null; } catch (e) { return null; } }; const MAJOR_CURRENCIES = ["USD", "EUR", "GBP", "CAD", "AUD", "JPY", "CHF", "CNY", "SGD", "HKD", "NZD", "SEK", "NOK", "DKK", "MXN", "BRL", "INR"]; const items = codes.map(code => ({ code, label: resolve(code) })); if (isCountries) { items.sort((a, b) => (a.label || a.code).localeCompare(b.label || b.code)); } else { const rank = code => { const i = MAJOR_CURRENCIES.indexOf(code); return i === -1 ? MAJOR_CURRENCIES.length : i; }; items.sort((a, b) => rank(a.code) - rank(b.code) || a.code.localeCompare(b.code)); } if (codes.length <= 3) { const parts = items.map(it => isCountries || !it.label ? it.label || it.code : `${it.label} (${it.code})`); const joined = parts.length === 1 ? parts[0] : parts.length === 2 ? `${parts[0]} and ${parts[1]}` : `${parts.slice(0, -1).join(", ")}, and ${parts[parts.length - 1]}`; return

{name} {verb} {joined}.

; } const chipStyle = { display: "inline-flex", alignItems: "baseline", gap: "0.4rem", padding: "0.15rem 0.55rem", borderRadius: "0.375rem", border: "1px solid rgba(128, 128, 128, 0.25)", fontSize: "0.875rem", lineHeight: 1.5 }; const codeStyle = { fontFamily: "var(--font-mono, ui-monospace, monospace)", fontWeight: 600, fontSize: "0.8125rem" }; const controlStyle = { color: "inherit", background: "transparent", border: "1px solid rgba(128, 128, 128, 0.3)", borderRadius: "0.5rem", fontSize: "0.875rem" }; const renderChip = it => {isCountries ? it.label || it.code : {it.code}} {!isCountries && it.label ? {it.label} : null} ; const PREVIEW = 5; const collapsible = items.length > PREVIEW; const q = query.trim().toLowerCase(); const filtered = q ? items.filter(it => it.code.toLowerCase().includes(q) || it.label && it.label.toLowerCase().includes(q)) : items; const expanded = open || q !== ""; const visible = !collapsible ? items : expanded ? filtered : items.slice(0, PREVIEW); const toggle = () => { const next = !open; setOpen(next); if (!next) setQuery(""); }; return

{name} {verb} the following {codes.length} {noun}:

{collapsible ? setQuery(e.target.value)} placeholder={`Filter ${noun}…`} aria-label={`Filter ${noun}`} style={{ ...controlStyle, display: "block", width: "100%", maxWidth: "22rem", padding: "0.4rem 0.7rem", margin: "0 0 0.75rem" }} /> : null}
{visible.map(renderChip)}
{q && filtered.length === 0 ?

No {noun} match “{query.trim()}”.

: null} {q && filtered.length > 0 ?

Showing {filtered.length} of {items.length}.

: null} {collapsible && !q ? : null}
; }; export const ConnectorCapabilities = ({data}) => { const CAPABILITIES = [{ keys: ["three_d_secure_hosted"], label: "3-D Secure (hosted)", description: "Gr4vy-hosted 3DS authentication flow.", cardOnly: true }, { keys: ["three_d_secure_pass_through"], label: "3-D Secure (pass-through)", description: "Pass through 3DS data authenticated by a third party.", cardOnly: true }, { keys: ["partial_authorization"], label: "Partial authorization", description: "Support partial approval responses." }, { keys: ["zero_auth"], label: "Zero auth", description: "Verify a card without charging it." }, { keys: ["void"], label: "Void", description: "Cancel an authorized transaction before capture." }, { keys: ["direct_capture"], label: "Direct capture", description: "Capture a payment immediately at authorization.", hideWhenUnsupported: true }, { keys: ["delayed_capture"], label: "Delayed capture", description: "Authorize a payment and capture it at a later time." }, { keys: ["partial_capture"], label: "Partial capture", description: "Capture a portion of the authorized amount." }, { keys: ["over_capture"], label: "Over capture", description: "Capture more than the originally authorized amount." }, { keys: ["refunds"], label: "Refunds", description: "Refund a captured payment." }, { keys: ["partial_refunds"], label: "Partial refunds", description: "Refund a portion of the captured amount." }, { keys: ["settlement_reporting"], label: "Settlement reporting", description: "Automatic settlement and reconciliation reporting." }, { keys: ["create_session"], label: "Create session", description: "Create a connector session for client-side flows." }, { keys: ["network_tokens_default", "network_tokens_toggle"], label: "Network tokens", description: "Network-level tokenization for improved approval rates.", cardOnly: true }, { keys: ["digital_wallets"], label: "Digital wallets", description: "Apple Pay, Google Pay, and other wallet integrations." }, { keys: ["payment_method_tokenization", "payment_method_tokenization_toggle"], label: "Payment method tokenization", description: "Store payment methods outside of transactions." }, { keys: ["transaction_sync"], label: "Transaction sync", description: "Synchronize transaction state from the connector." }, { keys: ["create_token"], label: "Tokenization", description: "Create a token from card details collected via Secure Fields.", hideWhenUnsupported: true }, { keys: ["delete_token"], label: "Delete token", description: "Delete a stored token.", hideWhenUnsupported: true }, { keys: ["verify_credentials"], label: "Verify credentials", description: "Validate the configured credentials against the connector.", hideWhenUnsupported: true }]; const raw = data && data.features; const enabled = typeof raw === "string" ? new Set(raw.split(/\s+/).filter(Boolean)) : Array.isArray(raw) ? new Set(raw) : new Set(Object.keys(raw || ({})).filter(key => raw[key])); const isOn = entry => entry.keys.some(key => enabled.has(key)); const isNonCard = data && data.method && data.method !== "card"; const renderGroup = (title, entries, supported) => { if (entries.length === 0) return null; const mark = supported ? "✓" : "✕"; const markColor = supported ? "#16a34a" : "#9ca3af"; return
{title}
{}
{entries.map(entry =>
{entry.label} {entry.description ? — {entry.description} : null}
)}
; }; const visible = isNonCard ? CAPABILITIES.filter(entry => !entry.cardOnly) : CAPABILITIES; const supported = visible.filter(isOn); const unsupported = visible.filter(entry => !isOn(entry) && !entry.hideWhenUnsupported); return
{renderGroup("Supported", supported, true)} {renderGroup("Not supported", unsupported, false)}
; }; Powertranz is a payment gateway that provides payment processing solutions for merchants in the Caribbean and Latin America. The platform supports card payments with features like delayed capture, partial refunds, 3-D Secure authentication, and payment method tokenization across multiple currencies and countries. ## Setup Speak to your Powertranz account manager to obtain your credentials. See the [Powertranz documentation](https://developer.powertranz.com/docs/api-keys) for more information. ## Credentials When setting up Powertranz in the dashboard, configure the following credentials: * **Powertranz ID** - Your merchant account identifier, for example `99901066`. * **Powertranz Password** - Your merchant account's unique password. * **Powertranz Gateway Key** (optional) - An additional token provided by Powertranz. Only set this if provided by Powertranz. ## Connector configuration After setting up your Powertranz connector in the dashboard, configure how transactions are routed to it. Choose one of the following options: * **Using Flow** - Configure Powertranz as the target connector in [Flow](/guides/dashboard/flow/overview) to automatically route card transactions to this connector * **Using the API** - Explicitly set the `payment_service_id` parameter to the Powertranz connector ID when creating transactions. This overrides any Flow routing rules. The connector ID can be found in the dashboard under **Connections** -> **Configured connections**. ## Capabilities ## Supported countries ## Supported currencies ## Limitations This is a closed-loop connector. Some failover scenarios are limited. For details, see [Open-loop versus closed-loop](/guides/features/recurring-payments/open-loop). ## Integration To accept card payments with Powertranz, use one of Gr4vy's client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using: * **[Embed](/guides/payments/embed/quick-start)** - A pre-built, customizable payment form that handles the complete payment flow * **[Secure Fields](/guides/payments/secure-fields/quick-start)** - Embed card input fields for building custom payment forms while maintaining PCI compliance * **[Mobile SDKs](/guides/get-started#sdks-and-plugins)** - Native SDKs for iOS, Android, React Native, and other platforms Powertranz also supports a [server-side card integration](#direct-integration) for PCI Level 1 compliant merchants. ## 3-D Secure By default, the Powertranz connector attempts 3DS authentication for every card transaction. To skip 3DS for a specific transaction, pass the `skipThreeDSecure` connection option. ```csharp C# highlight={6-12} theme={"system"} var transaction = await client.Transactions.CreateAsync( transactionCreate: new TransactionCreate() { Amount = 1299, Currency = "TTD", ConnectionOptions = new TransactionCreateConnectionOptions() { PowertranzCard = new ConnectionOptionsPowertranzCard() { SkipThreeDSecure = "true", }, }, Country = "TT", PaymentMethod = TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate( new CardPaymentMethodCreate() { Method = "card", Number = "4111111111111111", ExpirationDate = "12/30", SecurityCode = "123", } ), } ); ``` ```go Go highlight={1-5,12} theme={"system"} connectionOptions := components.TransactionCreateConnectionOptions{ PowertranzCard: &components.ConnectionOptionsPowertranzCard{ SkipThreeDSecure: gr4vy.String("true"), }, } transactionCreate := components.TransactionCreate{ Amount: amount, Currency: currency, Country: &country, ConnectionOptions: &connectionOptions, PaymentMethod: &paymentMethod, } transaction, err := client.Transactions.Create(ctx, transactionCreate, nil, nil, nil) ``` ```java Java highlight={5-9} theme={"system"} CreateTransactionResponse transactionResponse = gr4vyClient.transactions().create() .transactionCreate(TransactionCreate.builder() .amount(1299L) .currency("TTD") .connectionOptions(TransactionCreateConnectionOptions.builder() .powertranzCard(ConnectionOptionsPowertranzCard.builder() .skipThreeDSecure("true") .build()) .build()) .country("TT") .paymentMethod(TransactionCreatePaymentMethod.of(CardPaymentMethodCreate.builder() .method("card") .number("4111111111111111") .expirationDate("12/30") .securityCode("123") .build())) .build()) .call(); ``` ```php PHP highlight={5-9} theme={"system"} $transactionCreate = new TransactionCreate( amount: 1299, currency: 'TTD', country: 'TT', connectionOptions: new TransactionCreateConnectionOptions( powertranzCard: new ConnectionOptionsPowertranzCard( skipThreeDSecure: 'true' ) ), paymentMethod: new CardPaymentMethodCreate( method: 'card', number: '4111111111111111', expirationDate: '12/30', securityCode: '123' ) ); $response = $client->transactions->create($transactionCreate); ``` ```python Python highlight={5-9} theme={"system"} transaction: models.Transaction = client.transactions.create( amount=1299, currency="TTD", country="TT", connection_options={ "powertranz-card": { "skip_three_d_secure": "true", }, }, payment_method={ "method": "card", "number": "4111111111111111", "expiration_date": "12/30", "security_code": "123", } ) ``` ```ts TypeScript highlight={5-9} theme={"system"} const transaction = await client.transactions.create({ amount: 1299, currency: "TTD", country: "TT", connectionOptions: { "powertranz-card": { skipThreeDSecure: "true", }, }, paymentMethod: { method: "card", number: "4111111111111111", expirationDate: "12/30", securityCode: "123" } }) ``` To test Powertranz 3DS, refer to their documentation which [lists various test cards](https://developer.powertranz.com/docs/test-cards-and-cases). When 3DS is enabled, Powertranz may perform a redirect to authenticate the card, even when the card is not enrolled in 3DS. This redirect completes frictionless without the buyer's explicit approval. ## Recurring payments Powertranz does not support [open loop](/guides/features/recurring-payments/open-loop) payments. It does support recurring payments with the `payment_source` set to either `card_on_file` or `recurring`. For customer-initiated (CIT) payments, no additional data is required. For merchant-initiated (MIT) payments with either `card_on_file` or `recurring`, pass the `scheme_transaction_id` from the previous transaction as the `previous_scheme_transaction_id` on the new transaction. The `previous_scheme_transaction_id` only needs to be sent if `merchant_initiated` is set to `true`. Always send the `scheme_transaction_id` returned in the response for the previous transaction in the series.