- Five management and inquiry endpoints: cancel payment, commission inquiry, save buyer, save seller, transaction inquiry
- OAuth2 client-credentials token obtained by Iris from apis.garantibbva.com.tr and sent as Bearer per request
- No PAN handling: the card-charge / 3-D Secure redirect flow is not part of this API
- Selectable as a payment provider on Iris payment records; routes tryable from the integrations hub with confirmation
- Request and response of every call logged in your tenant for reconciliation with the bank's own records
Garanti BBVA Secure Payment API Connector
Garanti BBVA's Secure Payment API for Turkish merchants — cancel payment, commission inquiry, save buyer, save seller and transaction inquiry — connected to Apivom Iris with your developer-portal OAuth client: Iris obtains the token, every call is logged, no card data is involved.
What you can do
Use cases
- Cancel a payment from the order record — When an order is withdrawn the same day, cancel the bank transaction from Iris and keep the bank's confirmation on the payment record.
- Know the commission before quoting — Run a commission inquiry for the amount and installment plan to show finance the bank fee before an invoice is issued.
- Reconcile with the bank — Use the transaction inquiry route to verify the bank-side status of a payment and settle differences between Iris and the bank statement.
Garanti BBVA, one of Türkiye's largest banks, publishes a Secure Payment API on its developer portal for merchants that settle through the bank. The surface catalogued in Apivom Atlas is the management and inquiry layer: cancel a payment, query the commission that applies to a transaction, register a buyer or a seller, and look up a transaction's status. All five routes are POST operations and none of them carries a card number — the actual card charge with its 3-D Secure redirect is a separate bank flow outside this API. Apivom Iris connects as a selectable payment provider. The credential is the client id and client secret of your developer-portal application; Iris performs the OAuth2 client-credentials exchange against the bank's token endpoint and sends the short-lived Bearer token with each request, so the secret never leaves your tenant and Apivom Atlas stores nothing. Operators run the routes from the integrations hub with a confirmation step, and every request and the bank's response are logged in your tenant.
OAuth2 client credentials (client_id + client_secret) from the Garanti BBVA developer portal. Iris calls the bank's token endpoint itself and sends the resulting Bearer token per request; the secret stays encrypted in your Iris tenant and is never sent to Apivom Atlas.
Frequently asked questions
Can I charge a card through this connector?
No. This API covers cancellation, commission inquiry, buyer and seller registration and transaction inquiry only. The card-charge flow with its 3-D Secure redirect is a separate Garanti BBVA integration that is not part of this catalogue.
How is the OAuth token handled?
Iris requests a token from the bank's OAuth2 endpoint with your client id and client secret and sends the Bearer token on each call. The secret is encrypted in your tenant; Apivom Atlas only sees the short-lived token on the forwarded request and logs the call.
Does Apivom charge per API call for this connector?
No. Connectors are part of your Apivom tenant and are not metered in the Atlas portal. The vendor's own pricing, quotas and rate limits still apply to the account you connect — Apivom paces its calls to stay inside them and shows every call in your tenant's integration log.
Where are my credentials stored and who can see the traffic?
Apivom Atlas is a stateless gateway: it never stores vendor credentials or tokens. The Apivom product that connects keeps the credential encrypted in your tenant database, and every request and response is logged in your tenant only — your data is never shared across tenants.
More Atlas integrations
AI integration guide (llms.txt)
Machine-readable markdown — feed it to your AI assistant as integration instructions.