Providers
Open Banking

Open Banking Providers

Open Banking is Lunixi's shared OPEN_BANKING payment method. The buyer chooses their bank on your screen and approves the payment order on the bank's page; the money moves from the buyer's account to your provider account. The API and the Checkout Form use the same method contract.

ProviderProvider codeCustomer flowRefunds
CompayCOMPAYBank selection (bankCode) and approval on the bank's page (REDIRECT)None
Misyon Bank Ödeme İsteMISYONPayment request to the buyer's bank by IBAN, approved in the buyer's banking app (APP_APPROVAL)None

Read the providers and bank options from the GET /payments/methods?paymentMethod=OPEN_BANKING response rather than hard-coding this table.

Compay connection

A Compay connection requires a merchant agreement with Compay. Payments go directly to your merchant account at Compay.

  1. In the panel, select Compay under POS Center → Discover and click Aktif Et (Activate).
  2. Enter the details Compay gave you: Client ID, Store Key, API username and API password. If you use the details in Compay's test environment, turn on the Test environment setting.
  3. If your merchant category is games of chance or balance top-up, turn on the identity number required setting. While it is on you must send the buyer's Turkish identity number in buyer.identityNumber on every payment → Open Banking › Turkish identity number.
  4. In the connection's Agreement Permissions section, mark the Open Banking banks that are open in your contract with Compay. All banks start enabled; a bank you turn off cannot be used on any channel → Open Banking › Bank permissions.
  5. Enable the Open Banking method in the panel under Payment → Form Settings and select Compay.

The same COMPAY connection also runs the Shopping Loan method. Compay's redirect wallets (Paycell Cüzdan (Compay), fastPay, Passo Cüzdan) run as separate connections with the same merchant details; the panel lets you create these connections together with the same entry and update them together when you rotate keys → Wallet Providers.

The Compay connection supports open banking payments and result queries; open banking payments cannot be refunded.

Compay banks

The banks you can accept Open Banking payments from through Compay are listed below. The buyer only sees the banks you keep enabled in the Agreement Permissions section of your connection.

  • Akbank0046
  • Albaraka Türk0203
  • Burgan Bank0125
  • DenizBank0134
  • Fibabanka0103
  • Garanti BBVA0062
  • Halkbank0012
  • Kuveyt Türk0205
  • QNB Finansbank0111
  • TEB0032
  • Türkiye İş Bankası0064
  • Vakıf Katılım0210
  • VakıfBank0015
  • Yapı Kredi0067
  • Ziraat Bankası0010
  • Ziraat Katılım0209

Misyon Bank Ödeme İste connection

Request to Pay requires a creditor account and the Request to Pay service at Misyon Bank. Payments go directly to that account.

  1. In the panel, choose Misyon Bank Ödeme İste on POS Center → Discover and click Activate.
  2. Enter the details Misyon Bank gave you: Client ID, Client Secret, Application Code, Application Secret, Customer ID (your customer number at Misyon Bank), Channel Password and Account Number (the account that receives the payments). For a corporate account, enter the customer number of the user who operates it in User Customer ID.
  3. In Request to Pay Project, enter the project name Misyon Bank gave you. Leave Auth Project and Tenant Key empty unless Misyon Bank gave you a value.
  4. In Payment Purpose you can set one of Misyon Bank's FAST payment purpose codes; if empty, PersonalPayment is used.
  5. If you use test details, turn on Test Mode.
  6. In the panel, enable the Open Banking method on Payment → Form Settings. Request to Pay appears in the form as a row separate from the bank rows.

The Request to Pay connection makes payment requests and result queries; payments cannot be refunded and an open request cannot be withdrawn.