Android 및 iOS 네이티브 SDK

WebView 없이 결제 수단 선택 화면과 결제 화면을 네이티브로 제공합니다.

Native checkout flow

The merchant server creates checkout without currency or network and returns checkout_url.
The SDK validates the HTTPS /pay/{tradeId} URL.
The native page loads currencies, networks, and fee estimates.
Android opens compatible EVM wallets and provides manual copy actions; iOS keeps its address QR and copy flow.
The merchant server verifies payment before fulfillment.

1. Create checkout on the server

Keep X-API-Key on the server and omit currency and network to enable native selection.

// Trusted merchant server only. Never return the API Key to the app.
const response = await fetch('https://api.polypay.ai/api/v1/pay/order/checkout', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.POLYPAY_API_KEY!
  },
  body: JSON.stringify({
    mch_order_id: order.id,
    amount: order.amount,
    notify_url: 'https://merchant.example.com/webhooks/polypay'
    // Omit currency and network: the native SDK shows the selector.
  })
});

return { checkoutUrl: (await response.json()).data.checkout_url };

2. Install a native SDK

Android (Kotlin)

Use the Activity Result contract with the checkout URL returned by your server. Android API 24+.

dependencies {
  implementation("ai.polypay:checkout:0.1.1")
}

private val checkout = registerForActivityResult(PolyPayCheckoutContract()) { result ->
  // PAYMENT_DETECTED is not a fulfillment decision.
  viewModel.reconcileOnMerchantServer(result.tradeId)
}

checkout.launch(
  PolyPayCheckoutOptions(checkoutUrl = checkoutUrlFromYourServer)
)

iOS (SwiftUI or UIKit)

Add the Swift Package and present its SwiftUI view or UIKit controller. iOS 15+.

https://github.com/PolyPayAi/ios-sdk.git

let configuration = try PolyPayCheckoutConfiguration(
  checkoutURL: checkoutURLFromYourServer
)

PolyPayCheckoutView(configuration: configuration) { outcome in
  // paymentDetected is not a fulfillment decision.
  merchantAPI.reconcile(outcome)
}

Included native pages

Payment method	Currency, network, merchant default, and fee estimate.
Payment	Exact amount, network, address, copy actions, Android EVM wallet launch, and observed status.
Terminal states	Confirming, detected, expired, cancelled, error, and close.

Result and fulfillment authority

SDK 결과에는 paid가 없으며 이행 전 서버에서 대조해야 합니다.

Security requirements

Never place merchant credentials in the app.
Allow only exact HTTPS checkout hosts and /pay/{tradeId}.
Use server-provided amount, address, network, and fee data.
Use verified webhooks or authenticated server reconciliation as final authority.
Never fulfill from a client callback.

Release verification

Build and test both SDK packages.
Test selection and payment pages on real Android and iOS devices.
Test expiry, cancellation, confirmation, and network errors.
Verify app artifacts contain no merchant secret.
Verify client events cannot fulfill an order.