# One-time Payments ## How to use this document Use this page after the user scenario has been routed to One-time Payments. Choose one primary integration mode, start with that mode's integration guide, then add only the platform, payment method, API reference, sample, or notification docs required for the implementation. Before writing code, confirm: - Integration mode: CKP Hosted / CKP Embedded / Payment Element / API-only - Platform: Web/WAP / Android / iOS / Flutter / server-only - Backend language: Java / Python / Go / PHP / .NET - Special behavior: Apple Pay, Google Pay, save card, manual capture, server-side card collection, or regional payment methods (e.g., Indian APM, South Korean cards, PayPay) Stop after selecting the integration mode if the user only asks for selection or architecture advice. ## Overview Enables websites to accept payments via various global payment methods, supporting single-transaction scenarios such as one-time product purchases and service fee payments. ## Payment Methods - Credit card / debit card - Multiple global alternative payment methods (APM): digital wallets, online banking transfer, cash payment, real-time payment, buy now pay later, bank transfer, banking app --- ## Integration Solutions Choose one primary mode: | Scenario | Recommended mode | Start with | Add as needed | |---|---|---|---| | Quick onboarding, no UI customization needed | **CKP Hosted** | [Hosted mode](https://docs.antom.com/ac/cashierpay/HOSTEDCKP.md) | Apple Pay / Google Pay for Hosted CKP | | Embed the full checkout page and keep site navigation | **CKP Embedded** | [Embedded mode](https://docs.antom.com/ac/cashierpay/embeddedckp.md) | Apple Pay / Google Pay for Embedded CKP | | Embed payment components and control page layout | **Payment Element** | [Payment Element integration](https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/Payment-Element.md) | Element Apple Pay / Google Pay, appearance, mobile Element guides | | Full control over payment flow and UI | **API-only** | Select the matching API guide below | APM, card, or digital wallet API docs | | Alternative payment methods such as wallets or bank transfer | **API-only APM** | [APM payments](https://docs.antom.com/ac/cashierpay/apm_api.md) | Regional APM docs, API reference, server SDK sample | | Card entry hosted by Antom, no PCI certification | **API-only card hosted entry** | [Accept payments with Host Mode cards](https://docs.antom.com/ac/cashierpay/cardcollant.md) | Regional card docs, API reference, server SDK sample | | Merchant collects card data server-side | **API-only card server mode** | [Server Mode Card](https://docs.antom.com/ac/cashierpay/cardinfocallmerchant.md) | Requires PCI certification | | Direct Apple Pay / Google Pay API integration | **API-only digital wallet** | [Apple Pay API](https://docs.antom.com/ac/cashierpay/apay_apm_api.md) / [Google Pay API](https://docs.antom.com/ac/cashierpay/gpay_apm_api.md) | API reference, server SDK sample | --- ## Solution 1: Checkout Page (CKP) Antom-hosted payment UI and flow. Use Hosted mode for redirect checkout, or Embedded mode to place the complete checkout experience inside the merchant site. ### 1.1 Hosted CKP (Fully Hosted) **Best for:** - Fastest time-to-market - No frontend resources available - Simple integration without UI customization - Redirect-based payment flow **Integration guide / 集成指南:** - [Hosted mode](https://docs.antom.com/ac/cashierpay/HOSTEDCKP.md) **Add as needed:** - [Accept payments with Apple Pay](https://docs.antom.com/ac/cashierpay/apay_hostedckp.md) - [Accept payments with Google Pay](https://docs.antom.com/ac/cashierpay/gpay_hostedckp.md) ### 1.2 Embedded CKP **Best for:** - Want payment page embedded in your website - Maintain your site navigation and branding - Low-code but better user experience than redirect - Need modal/iframe payment experience **Integration guide / 集成指南:** - [Embedded mode](https://docs.antom.com/ac/cashierpay/embeddedckp.md) **Add as needed:** - [Accept payments with Apple Pay](https://docs.antom.com/ac/cashierpay/apay_embeddedckp.md) - [Accept payments with Google Pay](https://docs.antom.com/ac/cashierpay/gpay_embeddedckp.md) --- ## Solution 2: Payment Element Pre-built payment components embedded into the merchant checkout page. Use this when the merchant controls the page layout and Antom handles the payment components. **Best for:** - Need partial UI customization - Want balance between development effort and flexibility - Multiple payment methods in one integration - Custom checkout flow with Antom components **Integration guide / 集成指南:** - [Payment Element integration](https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/Payment-Element.md) **Add as needed:** - [Accept payments with Apple Pay](https://docs.antom.com/ac/cashierpay/apay_element.md) - [Accept payments with Google Pay](https://docs.antom.com/ac/cashierpay/gpay_element.md) - [Appearance customization](https://docs.antom.com/ac/cashierpay/appearance.md) **Mobile client integration (Android / iOS / Flutter):** - [Android Element guide](https://cdn.marmot-cloud.com/page/antom-integration-doc/element/android/integration-guide.md) - [iOS Element guide](https://cdn.marmot-cloud.com/page/antom-integration-doc/element/ios/integration-guide.md) - [Flutter Element guide](https://cdn.marmot-cloud.com/page/antom-integration-doc/element/flutter/integration-guide.md) For Web/WAP, use the Payment Element integration guide. For native mobile app integration, use the matching platform guide. --- ## Solution 3: API-only Integration Direct API integration where the merchant builds the frontend and backend payment flow. Use this for maximum control, specific payment-method flows, or server-to-server card processing. **Best for:** - Full control over payment UI/UX - Complex custom payment flows - Specific payment method integrations (APM, regional cards) - Server-to-server payment processing ### 3.1 APM API Integration For alternative payment methods such as digital wallets, bank transfers, cash payments, real-time payments, and BNPL. **Integration guide / 集成指南:** - [APM payments](https://docs.antom.com/ac/cashierpay/apm_api.md) **Add as needed:** - [Accept payments with Indian APM](https://docs.antom.com/ac/cashierpay/indian_apm.md) - [Accept payments with PayPay Smart Payment](https://docs.antom.com/ac/cashierpay/paypay_passwordfree.md) ### 3.2 Card API Integration（Hosted Mode） Redirects buyers to an Antom-hosted site for card entry, 3DS, and processing. No PCI certification required as merchants never touch card data. **Integration guide / 集成指南:** - [Accept payments with Host Mode cards](https://docs.antom.com/ac/cashierpay/cardcollant.md) **Add as needed:** - [Accept payments with South Korean issuer-authenticated cards](https://docs.antom.com/ac/cashierpay/issuer_auth_pay.md) - [Accept payments with Indian cards](https://docs.antom.com/ac/cashierpay/indian_card.md) ### 3.3 Card API Integration（Server Mode） For credit/debit card payments with full control. Requires PCI certification. **Integration guide / 集成指南:** - [Server Mode Card](https://docs.antom.com/ac/cashierpay/cardinfocallmerchant.md) ### 3.4 Digital Wallet API Integration For Apple Pay and Google Pay direct integration **Integration guides / 集成指南:** - [Accept payments with Apple Pay](https://docs.antom.com/ac/cashierpay/apay_apm_api.md) - [Accept payments with Google Pay](https://docs.antom.com/ac/cashierpay/gpay_apm_api.md) --- ## Payment Method Enum - [Payment Method Enum](https://docs.antom.com/ac/pm/enumeration_values.md) - Payment method types and API enum values --- ## Card Features | Scenario | Documentation | |----------|---------------| | Bind card & pay again with saved card | [Antom Tokenization](https://docs.antom.com/ac/pm/tokenization.md) | | Card on File (COF) transaction | [Card On File（COF）](https://docs.antom.com/ac/pm/cof.md) | --- ## API Reference Use API references for request/response bodies and parameter details after the selected mode's integration guide. - [API Overview](https://docs.antom.com/ac/ams/api_fund.md) - [Create Payment Session (One-time)](https://docs.antom.com/ac/ams/session_cashier.md) - [Pay (One-time Payments)](https://docs.antom.com/ac/ams/payment_cashier.md) - [Inquiry Payment](https://docs.antom.com/ac/ams/paymentri_online.md) - [Capture](https://docs.antom.com/ac/ams/capture.md) - [Cancel](https://docs.antom.com/ac/ams/paymentc_online.md) - [Notify Payment](https://docs.antom.com/ac/ams/paymentrn_online.md) - [Notify Capture](https://docs.antom.com/ac/ams/notify_capture.md) ## Server-side SDK Code Example Use the sample for the selected backend language after reading the selected mode's integration guide. - Java: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/java.md - Python: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/python.md - Go: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/go.md - PHP: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/php.md - .NET: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/dotnet.md ## Embedded Element Web SDK Code Example Use this after selecting Payment Element. Web SDK: https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/sample-code/web-sdk.md --- ## One-time Payments Notification Read the notification document that matches your integration mode: - CKP / Checkout Page -> [CKP Payment Notification](https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/notify/CKP.md) - API-only -> [API-only Payment Notification](https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/notify/API-only.md) - Payment Element -> [Element Payment Notification](https://cdn.marmot-cloud.com/page/antom-integration-doc/one-time-payments/notify/Element.md)