Antom Demo Easysafepay

"use strict"; const {jsx: _jsx, jsxs: _jsxs} = arguments[0]; function _createMdxContent(props) { const _components = { p: "p", ...props.components }, {Alert, AntomChannelFilterV2, AntomChunk, AntomCommand, AntomCondition, AntomDownloadBtn, AntomFile, AntomIntegrationBuilder, AntomPartial, AntomStep, AntomStepSection, Heading, InlineContent, Link, MdxDocument, Paragraph, Quote, Spacer, Tab, TabGroup, Text} = _components; if (!Alert) _missingMdxReference("Alert", true); if (!AntomChannelFilterV2) _missingMdxReference("AntomChannelFilterV2", true); if (!AntomChunk) _missingMdxReference("AntomChunk", true); if (!AntomCommand) _missingMdxReference("AntomCommand", true); if (!AntomCondition) _missingMdxReference("AntomCondition", true); if (!AntomDownloadBtn) _missingMdxReference("AntomDownloadBtn", true); if (!AntomFile) _missingMdxReference("AntomFile", true); if (!AntomIntegrationBuilder) _missingMdxReference("AntomIntegrationBuilder", true); if (!AntomPartial) _missingMdxReference("AntomPartial", true); if (!AntomStep) _missingMdxReference("AntomStep", true); if (!AntomStepSection) _missingMdxReference("AntomStepSection", true); if (!Heading) _missingMdxReference("Heading", true); if (!InlineContent) _missingMdxReference("InlineContent", true); if (!Link) _missingMdxReference("Link", true); if (!MdxDocument) _missingMdxReference("MdxDocument", true); if (!Paragraph) _missingMdxReference("Paragraph", true); if (!Quote) _missingMdxReference("Quote", true); if (!Spacer) _missingMdxReference("Spacer", true); if (!Tab) _missingMdxReference("Tab", true); if (!TabGroup) _missingMdxReference("TabGroup", true); if (!Text) _missingMdxReference("Text", true); return _jsx(MdxDocument, { children: _jsxs(AntomIntegrationBuilder, { channelFilter: _jsx(AntomChannelFilterV2, { data: [{ label: 'Integration Types:', key: 'integration_type', value: ['SDK'] }, { label: 'Platforms:', key: 'platform', value: ['Web', 'iOS', 'Android'] }, { label: 'Clients:', key: 'client', value: [{ when: { platform: 'Web' }, value: ['HTML', 'React', 'Vue'] }, { when: { platform: 'iOS' }, value: ['Objective-C'] }, { when: { platform: 'Android' }, value: ['Java'] }, { when: {}, value: ['HTML', 'React', 'Vue', 'Java', 'Objective-C'] }] }, { label: 'Servers:', key: 'server', value: ['Java', 'Python', 'PHP', 'Go', '.NET'] }] }), downloadFileName: 'antom-easysafepay-sample.zip', children: [_jsxs(AntomCondition, { when: { integration_type: 'SDK' }, children: [_jsx(Paragraph, { children: _jsx(_components.p, { children: "Create a smooth EasySafePay process by using Antom's payment capabilities. Antom offers client- and server-side sample code for SDK integration, to help you easily build a secure and simple payment experience." }) }), _jsx(AntomDownloadBtn, {})] }), _jsx(AntomStepSection, { number: 1, title: 'Set up the server' }), _jsxs(AntomStep, { id: 'install-antom-librar', when: { server: 'Java' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `install-antom-library`, children: _jsx(_components.p, { children: "Install the Antom Java library" }) }), _jsxs(TabGroup, { selector: `tabs`, children: [_jsxs(Tab, { id: `maven`, title: `Maven`, children: [_jsxs(Paragraph, { children: [_jsx(_components.p, { children: "To import the Antom Java library, add the dependency to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "pom.xml", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file. You can find the latest_version on" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-java', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub"] }) }), _jsx(_components.p, { children: "." })] }), _jsx(AntomCommand, { text: ` com.alipay.global.sdk global-open-sdk-java {latest_version} `, type: `copy` })] }), _jsx(Tab, { id: `github`, title: `GitHub`, children: _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "You can also download the source code directly from" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-java', target: "_blank", children: _jsxs(_components.p, { children: [' ', "GitHub", ' '] }) }), _jsx(_components.p, { children: "to install the Antom Java library." })] }) })] })] }), _jsxs(AntomStep, { id: 'install-antom-library', when: { server: 'Python' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `install-antom-library`, children: _jsx(_components.p, { children: "Install the Antom Python library" }) }), _jsxs(TabGroup, { selector: `tabs`, children: [_jsxs(Tab, { id: `maven`, title: `Maven`, children: [_jsxs(Paragraph, { children: [_jsx(_components.p, { children: "To import the Antom Python library, add the dependency to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "requirements.txt", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file. You can find the latest_version on" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-python', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub"] }) }), _jsx(_components.p, { children: "." })] }), _jsx(AntomCommand, { text: `global-open-sdk-python=={latest_version}`, type: `copy` })] }), _jsx(Tab, { id: `github`, title: `GitHub`, children: _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "You can also download the source code directly from" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-python', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub ", ' '] }) }), _jsx(_components.p, { children: "to install the Antom Python library." })] }) })] })] }), _jsxs(AntomStep, { id: 'install-antom-library', when: { server: 'PHP' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `install-antom-library`, children: _jsx(_components.p, { children: "Install the Antom PHP library" }) }), _jsxs(TabGroup, { selector: `tabs`, children: [_jsxs(Tab, { id: `maven`, title: `Maven`, children: [_jsxs(Paragraph, { children: [_jsx(_components.p, { children: "To import the Antom PHP library, add the dependency to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "composer.json", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file. You can find the latest_version on" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-php', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub"] }) }), _jsx(_components.p, { children: "." })] }), _jsx(AntomCommand, { text: `{ "require": { "antom/global-open-sdk-php": "{latest_version}" } }`, type: `copy` })] }), _jsx(Tab, { id: `github`, title: `GitHub`, children: _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "You can also download the source code directly from" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-php', target: "_blank", children: _jsxs(_components.p, { children: [' ', "GitHub", ' '] }) }), _jsx(_components.p, { children: "to install the Antom PHP library." })] }) })] })] }), _jsxs(AntomStep, { id: 'install-antom-library', when: { server: 'Go' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `install-antom-library`, children: _jsx(_components.p, { children: "Install the Antom Go library" }) }), _jsxs(TabGroup, { selector: `tabs`, children: [_jsxs(Tab, { id: `maven`, title: `Maven`, children: [_jsxs(Paragraph, { children: [_jsx(_components.p, { children: "To import the Antom Go library, add the dependency to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "go.mod", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file. You can find the latest_version on" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-go', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub"] }) }), _jsx(_components.p, { children: "." })] }), _jsx(AntomCommand, { text: `require ( github.com/alipay/global-open-sdk-go v{latest_version} )`, type: `copy` })] }), _jsx(Tab, { id: `github`, title: `GitHub`, children: _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "You can also download the source code directly from" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-go', target: "_blank", children: _jsxs(_components.p, { children: [' ', "GitHub", ' '] }) }), _jsx(_components.p, { children: "to install the Antom Go library." })] }) })] })] }), _jsxs(AntomStep, { id: 'install-antom-library', when: { server: '.NET' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `install-antom-library`, children: _jsx(_components.p, { children: "Install the Antom .NET library" }) }), _jsxs(TabGroup, { selector: `tabs`, children: [_jsxs(Tab, { id: `maven`, title: `Maven`, children: [_jsxs(Paragraph, { children: [_jsx(_components.p, { children: "To import the Antom .NET library, add the dependency to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), ".csproj", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file. You can find the latest_version on" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-dotnet', target: "_blank", children: _jsxs(_components.p, { children: [' ', " GitHub"] }) }), _jsx(_components.p, { children: "." })] }), _jsx(AntomCommand, { text: ` `, type: `copy` })] }), _jsx(Tab, { id: `github`, title: `GitHub`, children: _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "You can also download the source code directly from" }), _jsx(Link, { href: 'https://github.com/alipay/global-open-sdk-dotnet', target: "_blank", children: _jsxs(_components.p, { children: [' ', "GitHub", ' '] }) }), _jsx(_components.p, { children: "to install the Antom .NET library." })] }) })] })] }), _jsxs(AntomStep, { id: `get-integration-resources`, label: `server`, children: [_jsx(Heading, { level: 3, anchored: true, id: `get-integration-resources`, children: _jsx(_components.p, { children: "Get integration resources" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Get integration resources from the" }), _jsx(Link, { href: ' https://dashboard.antom.com/global-payments/developers/quickStart', target: "_blank", children: _jsxs(_components.p, { children: [' ', "Developer", ' '] }) }), _jsx(_components.p, { children: "section in Antom Dashboard. Configure the obtained integration resources in your application and these resources are to be further used when sending requests to the Antom server." })] })] }), _jsxs(AntomStep, { id: `create-a-payment-session`, label: `server`, when: { integration_type: 'SDK' }, children: [_jsx(Heading, { level: 3, anchored: true, id: `create-a-payment-session`, children: _jsx(_components.p, { children: "Create a payment session" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Add an endpoint on your server to call the" }), _jsx(Link, { href: "https://docs.antom.com/ac/ams/createpaymentsession_easypay", target: "_blank", children: _jsx(Text, { isBold: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "createPaymentSession", _jsx(Spacer, { len: 1 })] }) }) }), _jsx(_components.p, { children: "API. When the buyer makes the first payment, specify the authorization information, payment method, payment amount, payment currency, payment request ID, settlement currency, order information, and other required information for this payment. Subsequent payments do not require specifying authorization information, but you need to specify the token additionally." })] })] }), _jsxs(AntomStep, { id: 'specify-the-payment-redirect-url', label: `server`, children: [_jsx(Heading, { level: 3, anchored: true, id: `specify-the-payment-redirect-url`, children: _jsx(_components.p, { children: "Specify the payment redirection URL" }) }), _jsx(Paragraph, { children: _jsx(_components.p, { children: "Set the payment redirection URL, where the buyer is to be redirected after completing the payment. You can guide the buyer with further actions on this page." }) })] }), _jsxs(AntomStep, { id: 'receive-auth-notification', label: `server`, children: [_jsx(Heading, { level: 3, anchored: true, id: `receive-auth-notification`, children: _jsx(_components.p, { children: "Receive authorization notification" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "After the buyer completes authorization, the Antom server sends a notification to the" }), _jsx(Link, { href: "https://dashboard.antom.com/global-payments/developers/iNotify", target: "_blank", children: _jsxs(_components.p, { children: [' ', "Notification URL", ' '] }) }), _jsx(_components.p, { children: "you set, including authorizationNotifyType, authState, accessToken, userLoginId, etc. Save the correspondence between the information and the buyer for future password-free payments." })] })] }), _jsxs(AntomStep, { id: `inquire-payment-result`, label: `server`, children: [_jsx(Heading, { level: 3, anchored: true, id: `inquire-payment-result`, children: _jsx(_components.p, { children: "Inquire about the payment result" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Add an endpoint on your server to get the payment result by calling the" }), _jsx(Link, { href: "https://docs.antom.com/ac/ams/paymentri_online", target: "_blank", children: _jsx(Text, { isBold: true, children: _jsxs(_components.p, { children: [' ', "inquiryPayment", ' '] }) }) }), _jsx(_components.p, { children: "AP. Display the payment result when needed." })] })] }), _jsx(AntomStepSection, { number: 2, title: 'Build a checkout page on the client' }), _jsxs(AntomStep, { id: 'install-antom-sdk', when: { platform: 'Web', client: 'html', integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'install-antom-sdk', children: _jsx(_components.p, { children: "Install Antom SDK" }) }), _jsx(Paragraph, { children: "Install the SDK resource package via CDN." }), _jsx(Alert, { bgColor: "#e6f6ff", style: { border: '1px solid #e7e9e8' }, children: _jsxs(Paragraph, { children: [_jsx(Text, { isBold: true, children: _jsx(Text, { children: _jsx(_components.p, { children: "Note" }) }) }), _jsx(Text, { children: _jsxs(_components.p, { children: [": Please replace", _jsx(Spacer, { len: 1 })] }) }), _jsx(InlineContent, { children: _jsx(Text, { children: _jsx(_components.p, { children: "{latest_version}" }) }) }), _jsx(Text, { children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "in the code with the", _jsx(Spacer, { len: 1 })] }) }), _jsx(Link, { href: "https://docs.antom.com/ac/sdks/sdk_release_note", target: "_blank", children: _jsx(Text, { children: _jsx(_components.p, { children: "latest version" }) }) }), _jsx(Text, { children: _jsx(_components.p, { children: "." }) })] }) }), _jsx(Paragraph, { children: _jsx(AntomCommand, { text: ``, type: `copy` }) }), _jsx(Paragraph, { children: _jsx(Quote, { children: _jsxs(_components.p, { children: [_jsx(Text, { isBold: true, children: "Note" }), ": The Antom SDK complies with PCI guidelines and guarantees that the user's payment information goes straight to Antom without passing through your server."] }) }) })] }), _jsxs(AntomStep, { id: 'install-antom-sdk', when: { platform: 'Web', integration_type: 'SDK' }, unless: { client: 'html' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'install-antom-sdk', children: _jsx(_components.p, { children: "Install Antom SDK" }) }), _jsx(Paragraph, { children: "Install the SDK resource package via npm:" }), _jsxs(Paragraph, { children: [_jsx(Text, { children: _jsxs(_components.p, { children: ["First, use npm to download", ' '] }) }), _jsx(InlineContent, { children: _jsx(Text, { children: _jsx(_components.p, { children: "@alipay/ams-checkout" }) }) }), _jsx(Text, { children: _jsx(_components.p, { children: "：" }) }), _jsx(AntomCommand, { text: `npm install @alipay/ams-checkout`, type: `copy` }), _jsx(_components.p, { children: "Method:" }), _jsx(AntomCommand, { text: `import { AMSCashierPayment } from '@alipay/ams-checkout';`, type: `copy` })] }), _jsx(Paragraph, { children: _jsx(Quote, { children: _jsxs(_components.p, { children: [_jsx(Text, { isBold: true, children: "Note" }), ": The Antom SDK complies with PCI guidelines and guarantees that the user's payment information goes straight to Antom without passing through your server."] }) }) })] }), _jsxs(AntomStep, { id: 'install-antom-sdk', when: { platform: 'Android', integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'install-antom-sdk', children: _jsx(_components.p, { children: "Integrate Antom SDK" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Integrate the Android SDK package with Maven. For details, refer to" }), _jsx(Link, { href: "https://docs.antom.com/ac/sdks/android", target: "_blank", children: _jsxs(_components.p, { children: [' ', "Integrate the SDK Package for Android"] }) }), _jsx(_components.p, { children: "." })] }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Add the dependencies in the" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "build.gradle", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "file using the code snippet below." })] }), _jsx(Alert, { bgColor: "#e6f6ff", style: { border: '1px solid #e7e9e8' }, children: _jsxs(Paragraph, { children: [_jsx(Text, { isBold: true, children: _jsx(Text, { children: _jsx(_components.p, { children: "Note" }) }) }), _jsx(Text, { children: _jsxs(_components.p, { children: [": Please replace", _jsx(Spacer, { len: 1 })] }) }), _jsx(InlineContent, { children: _jsx(Text, { children: _jsx(_components.p, { children: "{latest_version}" }) }) }), _jsx(Text, { children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "in the code with the", _jsx(Spacer, { len: 1 })] }) }), _jsx(Link, { href: "https://docs.antom.com/ac/sdks/sdk_release_note", target: "_blank", children: _jsx(Text, { children: _jsx(_components.p, { children: "latest version" }) }) }), _jsx(Text, { children: _jsx(_components.p, { children: "." }) })] }) }), _jsx(AntomCommand, { text: `implementation "com.alipay.antom.sdk:payment-component:{latest_version}" implementation "com.alipay.antom.sdk:securitysdk:1.1.0"`, type: `copy` })] }), _jsxs(AntomStep, { id: 'install-antom-sdk', when: { platform: 'iOS', integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'install-antom-sdk', children: _jsx(_components.p, { children: "Integrate Antom SDK" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Integrate the iOS SDK package with CocoaPods. For details, refer to" }), _jsx(Link, { href: "https://docs.antom.com/ac/sdks/ios", target: "_blank", children: _jsxs(_components.p, { children: [' ', "Integrate the SDK Package for iOS"] }) }), _jsx(_components.p, { children: "." })] }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "Add the dependencies to your" }), _jsx(Text, { isItatic: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "Podfile", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "using the code snippet below:" })] }), _jsx(AntomCommand, { text: ` source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git' source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom' platform :ios, '11.0' target 'easypay_objc' do use_frameworks! pod 'AMSComponent' pod 'AMSSecurity' end`, type: `copy` })] }), _jsxs(AntomStep, { id: 'build-the-easysafepay-page', label: `client`, children: [_jsx(Heading, { level: 3, anchored: true, id: 'build-the-easysafepay-page', children: _jsx(_components.p, { children: "Build the checkout page" }) }), _jsx(Paragraph, { children: _jsx(_components.p, { children: "Display the EasySafePay methods that you offer to buyers on the checkout page." }) })] }), _jsxs(AntomPartial, { children: [_jsxs(AntomStep, { id: 'initialize-instantiate-the-sdk', when: { integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'initialize-instantiate-the-sdk', children: _jsx(_components.p, { children: "Initialize and instantiate the SDK" }) }), _jsx(Paragraph, { children: _jsx(_components.p, { children: "Create the SDK instance and specify basic configurations." }) })] }), _jsxs(AntomStep, { id: 'get-a-payment-session', when: { integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'get-a-payment-session', children: _jsx(_components.p, { children: "Get a payment session" }) }), _jsx(Paragraph, { children: _jsx(_components.p, { children: "After the buyer selects the corresponding EasySafePay method, you send the createPaymentSession request with the corresponding payment method information and get a payment session." }) })] }), _jsxs(AntomStep, { id: 'invoke-the-sdk', when: { integration_type: 'SDK' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'invoke-the-sdk', children: _jsx(_components.p, { children: "Invoke the SDK" }) }), _jsx(Paragraph, { children: _jsx(_components.p, { children: "Invoke the SDK by using the payment session obtained. After being invoked, the SDK guides the buyer to authorize the specified payment method and complete subsequent payments." }) })] })] }), _jsxs(AntomStep, { id: 'listen-for-callback-addresses', unless: { platform: 'Web' }, label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'listen-for-callback-addresses', children: _jsx(_components.p, { children: "Listen for payment redirection" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "After completing the payment, the buyer is redirected to the front-end page according to the" }), _jsx(Text, { isItatic: true, children: _jsx(Text, { children: _jsxs(_components.p, { children: [' ', "paymentRedirectUrl", ' '] }) }) }), _jsx(_components.p, { children: "you provided. The front-end needs to listen for this redirection to perform subsequent processing." })] })] }), _jsxs(AntomStep, { id: 'display-the-payment-result', label: 'client', children: [_jsx(Heading, { level: 3, anchored: true, id: 'display-the-payment-result', children: _jsx(_components.p, { children: "Query the payment result" }) }), _jsxs(Paragraph, { children: [_jsx(_components.p, { children: "After the buyer completes authorization, the Antom server processes the payment based on the previously saved payment information and redirects the buyer to the specified redirection URL. You can obtain the payment result by using the" }), _jsx(Text, { isBold: true, children: _jsxs(_components.p, { children: [_jsx(Spacer, { len: 1 }), "inquiryPayment", _jsx(Spacer, { len: 1 })] }) }), _jsx(_components.p, { children: "API on the server-side." })] })] }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/server/java/PaymentServer.java', when: { server: 'Java', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `java`, filename: 'src/main/java/com/antom/easysafepay/sdk/PaymentServer.java', downloadOnly: false, steps: [`get-integration-resources`, `create-a-payment-session`, `specify-the-payment-redirect-url`, `receive-auth-notification`, `inquire-payment-result`], children: [_jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`package com.antom.easysafepay.sdk; import com.alibaba.fastjson.JSON; import com.alipay.global.api.AlipayClient; import com.alipay.global.api.DefaultAlipayClient; import com.alipay.global.api.exception.AlipayApiException; import com.alipay.global.api.model.Result; import com.alipay.global.api.model.ResultStatusType; import com.alipay.global.api.model.ams.*; import com.alipay.global.api.model.constants.EndPointConstants; import com.alipay.global.api.model.constants.ProductSceneConstants; import com.alipay.global.api.request.ams.notify.AlipayAuthNotify; import com.alipay.global.api.request.ams.pay.AlipayPayQueryRequest; import com.alipay.global.api.request.ams.pay.AlipayPaymentSessionRequest; import com.alipay.global.api.response.ams.pay.AlipayPayQueryResponse; import com.alipay.global.api.response.ams.pay.AlipayPaymentSessionResponse; import com.alipay.global.api.tools.WebhookTool; import lombok.Data; import org.joda.money.CurrencyUnit; import org.joda.money.Money; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.http.ResponseEntity; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.CrossOrigin; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.ResponseBody; import javax.servlet.http.HttpServletRequest; import java.math.BigDecimal; import java.util.HashMap; import java.util.Map; import java.util.UUID; /** * sample payment server using Antom SDK integration mode **/ @Controller @CrossOrigin @SpringBootApplication public class PaymentServer { `] }, `server-Java-SDK-other1`), _jsx(AntomChunk, { language: `java`, steps: [`get-integration-resources`], chunks: [` /** * replace with your client id
* find your client id here: quickStart */ public static final String CLIENT_ID = "your_client_id"; /** * replace with your antom public key (used to verify signature)
* find your antom public key here: quickStart */ public static final String ANTOM_PUBLIC_KEY = "antom_public_key"; /** * replace with your private key (used to sign)
* please ensure the secure storage of your private key to prevent leakage */ public static final String MERCHANT_PRIVATE_KEY = "your_private_key"; private final static AlipayClient CLIENT = new DefaultAlipayClient( EndPointConstants.SG, MERCHANT_PRIVATE_KEY, ANTOM_PUBLIC_KEY, CLIENT_ID); `] }, `server-Java-SDK-code1`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` // Save the mapping between authState and payment information private static final Map authStatePayment = new HashMap<>(); // Save the mapping between userId and user info private static final Map users = new HashMap<>(); static { users.put("antom-easysafepay",new User("antom-easysafepay","852-91234567")); } public static void main(String[] args) { SpringApplication.run(PaymentServer.class, args); System.out.println("Open your browser and visit: http://localhost:8080"); } `] }, `server-Java-SDK-other2`), _jsx(AntomChunk, { language: `java`, steps: [`create-a-payment-session`], chunks: [` @PostMapping("/payment/createSession") public ResponseEntity createPaymentSession(@RequestBody PaymentVO payment) { AlipayPaymentSessionRequest alipayPaymentSessionRequest = new AlipayPaymentSessionRequest(); alipayPaymentSessionRequest.setProductCode(ProductCodeType.AGREEMENT_PAYMENT); alipayPaymentSessionRequest.setProductScene(ProductSceneConstants.EASY_PAY); // replace with your paymentRequestId String paymentRequestId = UUID.randomUUID().toString(); alipayPaymentSessionRequest.setPaymentRequestId(paymentRequestId); // convert amount unit(in practice, amount should be calculated on your serverside) // For details, please refer to: Usage rules of the Amount object long amountMinorLong = Money.of(CurrencyUnit.of(payment.currency), new BigDecimal(payment.amountValue)).getAmountMinorLong(); // set amount Amount amount = Amount.builder().currency(payment.currency).value(String.valueOf(amountMinorLong)).build(); alipayPaymentSessionRequest.setPaymentAmount(amount); // set settlement strategy // replace with your existing settlement currency SettlementStrategy settlementStrategy = SettlementStrategy.builder().settlementCurrency("USD").build(); alipayPaymentSessionRequest.setSettlementStrategy(settlementStrategy); User loginUser = users.get(payment.getUserId()); // set paymentMethod PaymentMethod paymentMethod = PaymentMethod.builder().paymentMethodType(payment.paymentMethodType).build(); if(loginUser.getPaymentMethodTypeAccessToken().containsKey(payment.getPaymentMethodType())){ // user has authorized String accessToken = loginUser.getPaymentMethodTypeAccessToken().get(payment.getPaymentMethodType()); paymentMethod.setPaymentMethodId(accessToken); }else{ // set agreementInfo // replace with your authState String authState = UUID.randomUUID().toString(); // The login ID that the user used to register in the payment method client. The login ID can be the user's email address or phone number. // Specify this parameter to free users from manually entering their login IDs. String userLoginId = loginUser.getPhoneNumber(); AgreementInfo agreementInfo = AgreementInfo.builder().authState(authState).userLoginId(userLoginId).build(); alipayPaymentSessionRequest.setAgreementInfo(agreementInfo); // save the paymentMethodType corresponding to the authState authStatePayment.put(authState, payment); } alipayPaymentSessionRequest.setPaymentMethod(paymentMethod); // set buyer info Buyer buyer = Buyer.builder().referenceBuyerId("yourBuyerId").build(); // replace with your orderId String orderId = UUID.randomUUID().toString(); // set order Info Order order = Order.builder().referenceOrderId(orderId). orderDescription("antom sdk testing order").orderAmount(amount).buyer(buyer).build(); alipayPaymentSessionRequest.setOrder(order); // replace with your notify url // or configure your notify url here: Notification URL alipayPaymentSessionRequest.setPaymentNotifyUrl("http://www.yourNotifyUrl.com/payment/receivePaymentNotify"); `] }, `server-Java-SDK-code2`), _jsx(AntomChunk, { language: `java`, steps: [`specify-the-payment-redirect-url`], chunks: [` // replace with your redirect url alipayPaymentSessionRequest.setPaymentRedirectUrl( "http://localhost:8080/index.html?paymentRequestId=" + paymentRequestId); `] }, `server-Java-SDK-code3`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` AlipayPaymentSessionResponse alipayPaymentSessionResponse; try { long startTime = System.currentTimeMillis(); System.out.println("payment request: " + JSON.toJSONString(alipayPaymentSessionRequest)); alipayPaymentSessionResponse = CLIENT.execute(alipayPaymentSessionRequest); System.out.println("payment response: " + JSON.toJSONString(alipayPaymentSessionResponse)); System.out.println("payment request cost time: " + (System.currentTimeMillis() - startTime) + "ms\\n"); } catch (AlipayApiException e) { return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, payment.getUserId(), e)); } return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, payment.getUserId(), alipayPaymentSessionResponse)); } `] }, `server-Java-SDK-other3`), _jsx(AntomChunk, { language: `java`, steps: [`receive-auth-notification`], chunks: [` @PostMapping("/authorizations/receiveAuthNotify") @ResponseBody public Result receiveAuthNotify(HttpServletRequest request, @RequestBody String notifyBody) { // retrieve the required parameters from http request String requestUri = request.getRequestURI(); String requestMethod = request.getMethod(); // retrieve the required parameters from request header String requestTime = request.getHeader("request-time"); String clientId = request.getHeader("client-id"); String signature = request.getHeader("signature"); try { // verify the signature of notification boolean verifyResult = WebhookTool.checkSignature(requestUri, requestMethod, clientId, requestTime, signature, notifyBody, ANTOM_PUBLIC_KEY); if (!verifyResult) { throw new RuntimeException("Invalid notify signature"); } // deserialize the notification body AlipayAuthNotify authNotify = JSON.parseObject(notifyBody,AlipayAuthNotify.class); if (authNotify != null && "SUCCESS".equals(authNotify.getResult().getResultCode()) && "TOKEN_CREATED".equals(authNotify.getAuthorizationNotifyType())) { // save user's PaymentMethodType corresponding to accessToken PaymentVO payment = authStatePayment.get(authNotify.getAuthState()); User user = users.get(payment.getUserId()); user.getPaymentMethodTypeAccessToken().put(payment.getPaymentMethodType(), authNotify.getAccessToken()); return Result.builder().resultCode("SUCCESS").resultMessage("success.").resultStatus(ResultStatusType.S).build(); } } catch (Exception e) { return Result.builder().resultCode("FAIL").resultMessage("fail.").resultStatus(ResultStatusType.F).build(); } return Result.builder().resultCode("SYSTEM_ERROR").resultMessage("system error.").resultStatus(ResultStatusType.F).build(); } `] }, `server-Java-SDK-code4`), _jsx(AntomChunk, { language: `java`, steps: [`inquire-payment-result`], chunks: [` @PostMapping("/payment/inquiryPayment") public ResponseEntity inquiryPayment(@RequestBody Map map) { String paymentRequestId = map.get("paymentRequestId"); AlipayPayQueryRequest alipayPayQueryRequest = new AlipayPayQueryRequest(); alipayPayQueryRequest.setPaymentRequestId(paymentRequestId); AlipayPayQueryResponse alipayPayQueryResponse; try { long startTime = System.currentTimeMillis(); System.out.println("inquiry payment request: " + JSON.toJSONString(alipayPayQueryRequest)); alipayPayQueryResponse = CLIENT.execute(alipayPayQueryRequest); System.out.println("inquiry payment response: " + JSON.toJSONString(alipayPayQueryResponse)); System.out.println("inquiry payment request cost time: " + (System.currentTimeMillis() - startTime) + "ms\\n"); } catch (AlipayApiException e) { return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, "", e)); } return ResponseEntity.ok().body(new ApiResponse(paymentRequestId, "", alipayPayQueryResponse)); } `] }, `server-Java-SDK-code5`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` @Data private static class User{ private String userId; private String phoneNumber; private Map paymentMethodTypeAccessToken; public User(String userId,String phoneNumber) { this.userId = userId; this.phoneNumber = phoneNumber; this.paymentMethodTypeAccessToken = new HashMap<>(); } } @Data public static class PaymentVO { private String userId; private String amountValue; private String currency; private String paymentMethodType; } @Data private static class ApiResponse { private String status = "success"; private String paymentRequestId; private String userId; private String message; private Object data; public ApiResponse(String paymentRequestId, String userId, Object data) { this.paymentRequestId = paymentRequestId; this.userId = userId; this.data = data; } public ApiResponse(String paymentRequestId, String userId, Exception e) { this.paymentRequestId = paymentRequestId; this.userId = userId; this.status = "error"; this.message = e.getMessage(); } } } `] }, `server-Java-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/server/python/server.py', when: { server: 'Python', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `python`, filename: 'server.py', downloadOnly: false, steps: [`get-integration-resources`, `create-a-payment-session`, `specify-the-payment-redirect-url`, `receive-auth-notification`, `inquire-payment-result`], children: [_jsx(AntomChunk, { language: `python`, steps: [``], chunks: [`#! /usr/bin/env python3 """ server.py Antom Sample. Python 3.9 or newer required. """ import json import time import uuid from com.alipay.ams.api.default_alipay_client import DefaultAlipayClient from com.alipay.ams.api.exception.exception import AlipayApiException from com.alipay.ams.api.model.agreement_info import AgreementInfo from com.alipay.ams.api.model.amount import Amount from com.alipay.ams.api.model.buyer import Buyer from com.alipay.ams.api.model.order import Order from com.alipay.ams.api.model.payment_method import PaymentMethod from com.alipay.ams.api.model.product_code_type import ProductCodeType from com.alipay.ams.api.model.settlement_strategy import SettlementStrategy from com.alipay.ams.api.request.notify.alipay_auth_notify import AlipayAuthNotify from com.alipay.ams.api.request.pay.alipay_create_session_request import AlipayCreateSessionRequest from com.alipay.ams.api.request.pay.alipay_pay_query_request import AlipayPayQueryRequest from com.alipay.ams.api.response.pay.alipay_create_session_response import AlipayCreateSessionResponse from com.alipay.ams.api.response.pay.alipay_pay_query_response import AlipayPayQueryResponse from com.alipay.ams.api.tools.webhook_tool import check_signature from flask import Flask, jsonify, request from flask_cors import CORS from money import Currency, Money `] }, `server-Python-SDK-other1`), _jsx(AntomChunk, { language: `python`, steps: [`get-integration-resources`], chunks: [`''' replace with your client id find your client id here: https://dashboard.antom.com/global-payments/developers/quickStart ''' CLIENT_ID = "your_client_id" ''' replace with your antom public key (used to verify signature) find your antom public key here: https://dashboard.antom.com/global-payments/developers/quickStart ''' ANTOM_PUBLIC_KEY = "antom_public_key" ''' replace with your private key (used to sign) please ensure the secure storage of your private key to prevent leakage ''' MERCHANT_PRIVATE_KEY = "antom_public_key" default_alipay_client = DefaultAlipayClient("https://open-sea-global.alipay.com", CLIENT_ID, MERCHANT_PRIVATE_KEY, ANTOM_PUBLIC_KEY) `] }, `server-Python-SDK-code1`), _jsx(AntomChunk, { language: `python`, steps: [``], chunks: [`# Save the mapping between authState and payment information auth_state_payment = {} # Save the mapping between userId and user info users = {} class User: def __init__(self, user_id, phone_number): self.__user_id = user_id self.__phoneNumber = phone_number self.__payment_method_type_access_token = {} def set_user_id(self, user_id): self.__user_id = user_id def get_user_id(self): return self.__user_id def set_phone_number(self, phone_number): self.__phoneNumber = phone_number def get_phone_number(self): return self.__phoneNumber def add_payment_method_type_access_token(self, payment_method_type, access_token): self.__payment_method_type_access_token[payment_method_type] = access_token def get_payment_method_type_access_token(self, payment_method_type): if payment_method_type in self.__payment_method_type_access_token: return self.__payment_method_type_access_token[payment_method_type] else: return None users['antom-easysafepay'] = User("antom-easysafepay", "852-91234567") app = Flask(__name__) CORS(app) `] }, `server-Python-SDK-other2`), _jsx(AntomChunk, { language: `python`, steps: [`create-a-payment-session`], chunks: [`@app.route("/payment/createSession", methods=['POST']) def create_payment_session(): payment_vo = request.get_json() alipay_create_session_request = AlipayCreateSessionRequest() alipay_create_session_request.product_code = ProductCodeType.AGREEMENT_PAYMENT alipay_create_session_request.product_scene = "EASY_PAY" # replace with your paymentRequestId payment_request_id = str(uuid.uuid4()) alipay_create_session_request.payment_request_id = payment_request_id # convert amount unit(in practice, amount should be calculated on your serverside) # For details, please refer to: https://docs.antom.com/ac/ref/cc money_sub_units = Money(payment_vo['amountValue'], Currency[payment_vo['currency']]).sub_units # set amount amount = amount = Amount(payment_vo['currency'], money_sub_units) alipay_create_session_request.payment_amount = amount # set settlement strategy settlement_strategy = SettlementStrategy() # replace with your existing settlement currency settlement_strategy.settlement_currency = "USD" alipay_create_session_request.settlement_strategy = settlement_strategy login_user = users.get(payment_vo['userId']) # set paymentMethod payment_method = PaymentMethod() payment_method.payment_method_type = payment_vo['paymentMethodType'] if login_user.get_payment_method_type_access_token(payment_vo['paymentMethodType']) is not None: # user has authorized access_token = login_user.get_payment_method_type_access_token(payment_vo['paymentMethodType']) payment_method.payment_method_id = access_token else: # set agreementInfo # replace with your authState auth_state = str(uuid.uuid4()) # The login ID that the user used to register in the payment method client. # The login ID can be the user's email address or phone number. # Specify this parameter to free users from manually entering their login IDs. user_login_id = login_user.get_phone_number() agreement_info = AgreementInfo() agreement_info.auth_state = auth_state agreement_info.user_login_id = user_login_id alipay_create_session_request.agreement_info = agreement_info # save the paymentMethodType corresponding to the authState auth_state_payment[auth_state] = payment_vo alipay_create_session_request.payment_method = payment_method # set buyer info buyer = Buyer() buyer.reference_buyer_id = "your_buyer_id" # replace with your orderId order_id = str(uuid.uuid4()) # set order info order = Order() order.reference_order_id = order_id order.order_description = "antom sdk testing order" order.order_amount = amount order.buyer = buyer alipay_create_session_request.order = order # replace with your notify url # or configure your notify url here: https://dashboard.antom.com/global-payments/developers/iNotify alipay_create_session_request.payment_notify_url = "http://www.yourNotifyUrl.com/payment/receivePaymentNotify" `] }, `server-Python-SDK-code2`), _jsx(AntomChunk, { language: `python`, steps: [`specify-the-payment-redirect-url`], chunks: [` # replace with your redirect url alipay_create_session_request.payment_redirect_url = f"http://localhost:5173/index.html?paymentRequestId={payment_request_id}" `] }, `server-Python-SDK-code3`), _jsx(AntomChunk, { language: `python`, steps: [``], chunks: [` try: start_time = time.time() print(f"paymentSession request: {alipay_create_session_request.to_ams_json()}") alipay_create_session_response_body = default_alipay_client.execute(alipay_create_session_request) alipay_create_session_response = AlipayCreateSessionResponse(alipay_create_session_response_body) print(f"paymentSession response: {alipay_create_session_response_body}") print(f"paymentSession request cost time: {time.time() - start_time}") except AlipayApiException as e: return jsonify(ApiResponse().error(payment_request_id, login_user.get_user_id(), e)) return jsonify(ApiResponse().success(payment_request_id, login_user.get_user_id(), json.loads(alipay_create_session_response_body))) `] }, `server-Python-SDK-other3`), _jsx(AntomChunk, { language: `python`, steps: [`receive-auth-notification`], chunks: [`@app.route("/authorizations/receiveAuthNotify", methods=['POST']) def receive_auth_notify(): # retrieve the required parameters from http request notify_body = request.get_data(as_text=True) request_uri = request.path request_method = request.method # retrieve the required parameters from request header headers = request.headers request_time = headers.get("request-time") client_id = headers.get("client-id") signature = headers.get("signature") try: # verify the signature of notification verify_result = check_signature(request_method, request_uri, client_id, request_time, str(notify_body), signature, ANTOM_PUBLIC_KEY) if not verify_result: raise Exception("Invalid notify signature") # deserialize the notification body alipay_auth_notify = AlipayAuthNotify(notify_body) if alipay_auth_notify.result.result_code == "SUCCESS" and alipay_auth_notify.authorization_notify_type == "TOKEN_CREATED": # save user's PaymentMethodType corresponding to accessToken payment_vo = auth_state_payment[alipay_auth_notify.auth_state] user = users.get(payment_vo['userId']) user.add_payment_method_type_access_token(payment_vo['paymentMethodType'], alipay_auth_notify.access_token) return jsonify({"result": {"resultCode": "SUCCESS", "resultMessage": "success.", "resultStatus": "S"}}) except Exception as e: print(str(e)) return jsonify({"result": {"resultCode": "FAIL", "resultMessage": "fail.", "resultStatus": "F"}}) return jsonify({"result": {"resultCode": "SYSTEM_ERROR", "resultMessage": "system error.", "resultStatus": 'F'}}) `] }, `server-Python-SDK-code4`), _jsx(AntomChunk, { language: `python`, steps: [``], chunks: [` `] }, `server-Python-SDK-other4`), _jsx(AntomChunk, { language: `python`, steps: [`inquire-payment-result`], chunks: [`@app.route("/payment/inquiryPayment", methods=['POST']) def inquery_payment(): inquery_vo = request.get_json() payment_request_id = inquery_vo.get("paymentRequestId") alipay_pay_query_request = AlipayPayQueryRequest() alipay_pay_query_request.payment_request_id = payment_request_id try: start_time = time.time() print(f"inquiry payment request: {alipay_pay_query_request.to_ams_json()}") alipay_pay_query_response_body = default_alipay_client.execute(alipay_pay_query_request) alipay_pay_query_response = AlipayPayQueryResponse(alipay_pay_query_response_body) print(f"inquiry payment response: {alipay_pay_query_response_body}") print(f"inquiry payment request cost time: {time.time() - start_time}") except AlipayApiException as e: return jsonify(ApiResponse().error(payment_request_id, "", e)) return jsonify(ApiResponse().success(payment_request_id, "", json.loads(alipay_pay_query_response_body))) `] }, `server-Python-SDK-code5`), _jsx(AntomChunk, { language: `python`, steps: [``], chunks: [` class ApiResponse: def __init__(self): self.__status = "success" self.__payment_request_id = "" self.__payment_user_id = "" self.__message = "" self.__data = None def success(self, payment_request_id, user_id, data): self.__payment_request_id = payment_request_id self.__payment_user_id = user_id self.__data = data return self.to_json() def error(self, payment_request_id, user_id, e): self.__status = "error" self.__payment_request_id = payment_request_id self.__payment_user_id = user_id self.__message = str(e) return self.to_json() def to_json(self): return { "status": self.__status, "paymentRequestId": self.__payment_request_id, "paymentUserId": self.__payment_user_id, "message": self.__message, "data": self.__data } if __name__ == '__main__': app.run(host='localhost', port=8080) `] }, `server-Python-SDK-other5`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/server/php/server.php', when: { server: 'PHP', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `php`, filename: 'server.php', downloadOnly: false, steps: [`get-integration-resources`, `create-a-payment-session`, `specify-the-payment-redirect-url`, `receive-auth-notification`, `inquire-payment-result`], children: [_jsx(AntomChunk, { language: `php`, steps: [``], chunks: [` * find your client id here: quickStart */ const CLIENT_ID = "your_client_id"; /** * replace with your antom public key (used to verify signature)
* find your antom public key here: quickStart */ const ANTOM_PUBLIC_KEY = "antom_public_key"; /** * replace with your private key (used to sign)
* please ensure the secure storage of your private key to prevent leakage */ const MERCHANT_PRIVATE_KEY = "your_private_key"; private static \$CLIENT; // Save the mapping between authState and payment information private static \$authStateFile = 'auth_state_payment.json'; // Save the mapping between userId and user info private static \$userFile = 'users.json'; public function __construct() { session_start(); self::\$CLIENT = new DefaultAlipayClient( "https://open-sea-global.alipay.com", self::MERCHANT_PRIVATE_KEY, self::ANTOM_PUBLIC_KEY, self::CLIENT_ID ); `] }, `server-PHP-SDK-code1`), _jsx(AntomChunk, { language: `php`, steps: [``], chunks: [` // Initialize users if not exists if (!file_exists(self::\$userFile)) { \$users = array( 'antom-easysafepay' => array( 'userId' => 'antom-easysafepay', 'phoneNumber' => '852-91234567', 'paymentMethodTypeAccessToken' => array() ) ); file_put_contents(self::\$userFile, json_encode(\$users)); } } `] }, `server-PHP-SDK-other2`), _jsx(AntomChunk, { language: `php`, steps: [`create-a-payment-session`], chunks: [` public function createPaymentSession(\$payment) { \$alipayPaymentSessionRequest = new AlipayPaymentSessionRequest(); \$alipayPaymentSessionRequest->setProductCode(ProductCodeType::AGREEMENT_PAYMENT); \$alipayPaymentSessionRequest->setProductScene('EASY_PAY'); // replace with your paymentRequestId \$paymentRequestId = uniqid('PR_'); \$alipayPaymentSessionRequest->setPaymentRequestId(\$paymentRequestId); // convert amount unit(in practice, amount should be calculated on your serverside) // For details, please refer to: Usage rules of the Amount object \$moneyParser = new DecimalMoneyParser(new ISOCurrencies()); \$money = \$moneyParser->parse((string)\$payment['amountValue'], new Currency(\$payment['currency'])); // set amount \$amount = new Amount(); \$amount->setCurrency(\$payment['currency']); \$amount->setValue(\$money->getAmount()); \$alipayPaymentSessionRequest->setPaymentAmount(\$amount); // set settlement strategy // replace with your existing settlement currency \$settlementStrategy = new SettlementStrategy(); \$settlementStrategy->setSettlementCurrency('USD'); \$alipayPaymentSessionRequest->setSettlementStrategy(\$settlementStrategy); \$loginUser = \$this->getUser(\$payment['userId']); // set paymentMethod \$paymentMethod = new PaymentMethod(); \$paymentMethod->setPaymentMethodType(\$payment['paymentMethodType']); if (isset(\$loginUser['paymentMethodTypeAccessToken'][\$payment['paymentMethodType']])) { // user has authorized \$accessToken = \$loginUser['paymentMethodTypeAccessToken'][\$payment['paymentMethodType']]; \$paymentMethod->setPaymentMethodId(\$accessToken); } else { // set agreementInfo // replace with your authState \$authState = uniqid('AUTH_'); // The login ID that the user used to register in the payment method client. The login ID can be the user's email address or phone number. // Specify this parameter to free users from manually entering their login IDs. \$userLoginId = \$loginUser['phoneNumber']; \$agreementInfo = new AgreementInfo(); \$agreementInfo->setAuthState(\$authState); \$agreementInfo->setUserLoginId(\$userLoginId); \$alipayPaymentSessionRequest->setAgreementInfo(\$agreementInfo); // save the paymentMethodType corresponding to the authState \$this->saveAuthStatePayment(\$authState, \$payment); } \$alipayPaymentSessionRequest->setPaymentMethod(\$paymentMethod); // set buyer info \$buyer = new Buyer(); \$buyer->setReferenceBuyerId("yourBuyerId"); // replace with your orderId \$orderId = uniqid('ORDER_'); // set order Info \$order = new Order(); \$order->setReferenceOrderId(\$orderId); \$order->setOrderDescription("antom sdk testing order"); \$order->setOrderAmount(\$amount); \$order->setBuyer(\$buyer); \$alipayPaymentSessionRequest->setOrder(\$order); // replace with your notify url // or configure your notify url here: Notification URL \$alipayPaymentSessionRequest->setPaymentNotifyUrl("http://www.yourNotifyUrl.com/payment/receivePaymentNotify"); `] }, `server-PHP-SDK-code2`), _jsx(AntomChunk, { language: `php`, steps: [`specify-the-payment-redirect-url`], chunks: [` // replace with your redirect url \$alipayPaymentSessionRequest->setPaymentRedirectUrl( "http://localhost:5173/index.html?paymentRequestId=" . \$paymentRequestId ); `] }, `server-PHP-SDK-code3`), _jsx(AntomChunk, { language: `php`, steps: [``], chunks: [` try { \$startTime = microtime(true); error_log("payment request: " . json_encode(\$alipayPaymentSessionRequest)); \$alipayPaymentSessionResponse = self::\$CLIENT->execute(\$alipayPaymentSessionRequest); error_log("payment response: " . json_encode(\$alipayPaymentSessionResponse)); error_log("payment request cost time: " . (microtime(true) - \$startTime) * 1000 . "ms\\n"); return \$this->apiResponse(\$paymentRequestId, \$payment['userId'], \$alipayPaymentSessionResponse); } catch (Exception \$e) { return \$this->apiResponse(\$paymentRequestId, \$payment['userId'], \$e); } } `] }, `server-PHP-SDK-other3`), _jsx(AntomChunk, { language: `php`, steps: [`receive-auth-notification`], chunks: [` public function receiveAuthNotify(\$request, \$notifyBody) { // retrieve the required parameters from http request \$requestUri = \$request->getResourceUri(); \$requestMethod = \$request->getMethod(); // retrieve the required parameters from request header \$requestTime = \$request->headers('request-time'); \$clientId = \$request->headers('client-id'); \$signature = \$request->headers('signature'); try { // verify the signature of notification if (empty(\$signature)) { throw new RuntimeException("Invalid notify signature"); }else{ \$parts = explode("signature=", \$signature); if(count(\$parts)>1){ \$realSignature = \$parts[1]; } } \$verifyResult = SignatureTool::verify( \$requestMethod, \$requestUri, \$clientId, \$requestTime, \$notifyBody, \$realSignature, self::ANTOM_PUBLIC_KEY ); if (!\$verifyResult) { throw new RuntimeException("Invalid notify signature"); } // deserialize the notification body \$authNotify = json_decode(\$notifyBody, true); if (\$authNotify && \$authNotify['result']['resultCode'] === 'SUCCESS' && \$authNotify['authorizationNotifyType'] === 'TOKEN_CREATED') { // save user's PaymentMethodType corresponding to accessToken \$payment = \$this->getAuthStatePayment(\$authNotify['authState']); \$user = \$this->getUser(\$payment['userId']); \$user['paymentMethodTypeAccessToken'][\$payment['paymentMethodType']] = \$authNotify['accessToken']; \$this->saveUser(\$user); return array( 'resultCode' => 'SUCCESS', 'resultMessage' => 'success.', 'resultStatus' => 'S' ); } } catch (Exception \$e) { return array( 'resultCode' => 'FAIL', 'resultMessage' => 'fail.', 'resultStatus' => 'F' ); } return array( 'resultCode' => 'SYSTEM_ERROR', 'resultMessage' => 'system error.', 'resultStatus' => 'F' ); } `] }, `server-PHP-SDK-code4`), _jsx(AntomChunk, { language: `php`, steps: [`inquire-payment-result`], chunks: [` public function inquiryPayment(\$data) { \$paymentRequestId = \$data['paymentRequestId']; \$alipayPayQueryRequest = new AlipayPayQueryRequest(); \$alipayPayQueryRequest->setPaymentRequestId(\$paymentRequestId); try { \$startTime = microtime(true); error_log("inquiry payment request: " . json_encode(\$alipayPayQueryRequest)); \$alipayPayQueryResponse = self::\$CLIENT->execute(\$alipayPayQueryRequest); error_log("inquiry payment response: " . json_encode(\$alipayPayQueryResponse)); error_log("inquiry payment request cost time: " . (microtime(true) - \$startTime) * 1000 . "ms\\n"); return \$this->apiResponse(\$paymentRequestId, "", \$alipayPayQueryResponse); } catch (Exception \$e) { return \$this->apiResponse(\$paymentRequestId, "", \$e); } } `] }, `server-PHP-SDK-code5`), _jsx(AntomChunk, { language: `php`, steps: [``], chunks: [` private function saveAuthStatePayment(\$authState, \$payment) { \$data = array(); if (file_exists(self::\$authStateFile)) { \$data = json_decode(file_get_contents(self::\$authStateFile), true); } \$data[\$authState] = \$payment; file_put_contents(self::\$authStateFile, json_encode(\$data)); } private function getAuthStatePayment(\$authState) { if (file_exists(self::\$authStateFile)) { \$data = json_decode(file_get_contents(self::\$authStateFile), true); return isset(\$data[\$authState]) ? \$data[\$authState] : null; } return null; } private function getUser(\$userId) { if (file_exists(self::\$userFile)) { \$users = json_decode(file_get_contents(self::\$userFile), true); return isset(\$users[\$userId]) ? \$users[\$userId] : null; } return null; } private function saveUser(\$user) { \$users = array(); if (file_exists(self::\$userFile)) { \$users = json_decode(file_get_contents(self::\$userFile), true); } \$users[\$user['userId']] = \$user; file_put_contents(self::\$userFile, json_encode(\$users)); } private function apiResponse(\$paymentRequestId, \$userId, \$data) { if (\$data instanceof Exception) { return array( 'status' => 'error', 'paymentRequestId' => \$paymentRequestId, 'userId' => \$userId, 'message' => \$data->getMessage() ); } return array( 'status' => 'success', 'paymentRequestId' => \$paymentRequestId, 'userId' => \$userId, 'data' => \$data ); } } // Slim Framework routes setup \$app = new \\Slim\\Slim(array( 'base.path' => '' )); // Add CORS middleware \$app->response->headers->set('Access-Control-Allow-Origin', '*'); \$app->response->headers->set('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS'); \$app->response->headers->set('Access-Control-Allow-Headers', 'Content-Type, X-Requested-With, Authorization'); // Add OPTIONS request handler \$app->options('/(:path+)', function () use (\$app) { \$app->response->setStatus(200); }); \$paymentServer = new PaymentServer(); \$app->post('/payment/createSession', function () use (\$app, \$paymentServer) { \$payment = \$app->request->getBody(); \$payment = json_decode(\$payment, true); \$response = \$paymentServer->createPaymentSession(\$payment); \$app->response->headers->set('Content-Type', 'application/json'); echo json_encode(\$response); }); \$app->post('/authorizations/receiveAuthNotify', function () use (\$app, \$paymentServer) { \$notifyBody = \$app->request->getBody(); \$response = \$paymentServer->receiveAuthNotify(\$app->request, \$notifyBody); \$app->response->headers->set('Content-Type', 'application/json'); echo json_encode(\$response); }); \$app->post('/payment/inquiryPayment', function () use (\$app, \$paymentServer) { \$data = \$app->request->getBody(); \$data = json_decode(\$data, true); \$response = \$paymentServer->inquiryPayment(\$data); \$app->response->headers->set('Content-Type', 'application/json'); echo json_encode(\$response); }); \$app->run(); `] }, `server-PHP-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/server/go/server.go', when: { server: 'Go', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `go`, filename: 'server.go', downloadOnly: false, steps: [`get-integration-resources`, `create-a-payment-session`, `specify-the-payment-redirect-url`, `receive-auth-notification`, `inquire-payment-result`], children: [_jsx(AntomChunk, { language: `go`, steps: [``], chunks: [`package main import ( "encoding/json" "fmt" "github.com/Rhymond/go-money" "github.com/alipay/global-open-sdk-go/com/alipay/api/model" "github.com/alipay/global-open-sdk-go/com/alipay/api/request/notify" "github.com/alipay/global-open-sdk-go/com/alipay/api/request/pay" "github.com/alipay/global-open-sdk-go/com/alipay/api/response" "github.com/alipay/global-open-sdk-go/com/alipay/api/tools" "io" "log" "net/http" "strconv" "sync" "time" defaultAlipayClient "github.com/alipay/global-open-sdk-go/com/alipay/api" "github.com/google/uuid" ) `] }, `server-Go-SDK-other1`), _jsx(AntomChunk, { language: `go`, steps: [`get-integration-resources`], chunks: [`const ( /* replace with your client id
find your client id here: quickStart */ ClientID = "your_client_id" /* replace with your antom public key (used to verify signature)
find your antom public key here: quickStart */ AntomPublicKey = "antom_public_key" /* replace with your private key (used to sign)
please ensure the secure storage of your private key to prevent leakage */ MerchantPrivateKey = "your_private_key" ) func init() { client = defaultAlipayClient.NewDefaultAlipayClient( "https://open-sea-global.alipay.com", ClientID, MerchantPrivateKey, AntomPublicKey) // Initialize users map with a default user users.Store("antom-easysafepay", &User{ UserID: "antom-easysafepay", PhoneNumber: "852-91234567", PaymentMethodTypeAccessToken: make(map[string]string), }) } `] }, `server-Go-SDK-code1`), _jsx(AntomChunk, { language: `go`, steps: [``], chunks: [`// Initialize global client var client *defaultAlipayClient.DefaultAlipayClient // Save the mapping between authState and payment information var authStatePayment sync.Map // Save the mapping between userId and user info var users sync.Map func main() { // Register routes http.HandleFunc("/payment/createSession", enableCORS(handleCreateSession)) http.HandleFunc("/authorizations/receiveAuthNotify", enableCORS(handleReceiveAuthNotify)) http.HandleFunc("/payment/inquiryPayment", enableCORS(handleInquiryPayment)) fmt.Println("Open your browser and visit: http://localhost:8080") log.Fatal(http.ListenAndServe(":8080", nil)) } `] }, `server-Go-SDK-other2`), _jsx(AntomChunk, { language: `go`, steps: [`create-a-payment-session`], chunks: [`func handleCreateSession(w http.ResponseWriter, r *http.Request) { if r.Method != http.MethodPost { http.Error(w, "Method not allowed", http.StatusMethodNotAllowed) return } var payment PaymentVO json.NewDecoder(r.Body).Decode(&payment) request, sessionRequest := pay.NewAlipayPaymentSessionRequest() sessionRequest.ProductCode = model.AGREEMENT_PAYMENT sessionRequest.ProductScene = "EASY_PAY" // replace with your paymentRequestId paymentRequestId := uuid.New().String() sessionRequest.PaymentRequestId = paymentRequestId // convert amount unit(in practice, amount should be calculated on your serverside) // For details, please refer to: Usage rules of the Amount object parseFloat, _ := strconv.ParseFloat(payment.AmountValue, 64) amountValue := money.NewFromFloat(parseFloat, payment.Currency).Amount() // set amount amount := &model.Amount{Value: strconv.FormatInt(amountValue, 10), Currency: payment.Currency} sessionRequest.PaymentAmount = amount // set settlement strategy // replace with your existing settlement currency sessionRequest.SettlementStrategy = &model.SettlementStrategy{SettlementCurrency: "USD"} userValue, _ := users.Load(payment.UserID) loginUser := userValue.(*User) // set paymentMethod paymentMethod := &model.PaymentMethod{PaymentMethodType: payment.PaymentMethodType} if accessToken, exists := loginUser.PaymentMethodTypeAccessToken[payment.PaymentMethodType]; exists { // user has authorized paymentMethod.PaymentMethodId = accessToken } else { // set agreementInfo // replace with your authState authState := uuid.New().String() // The login ID that the user used to register in the payment method client. The login ID can be the user's email address or phone number. // Specify this parameter to free users from manually entering their login IDs. userLoginId := loginUser.PhoneNumber agreementInfo := &model.AgreementInfo{ AuthState: authState, UserLoginId: userLoginId, } sessionRequest.AgreementInfo = agreementInfo // save the paymentMethodType corresponding to the authState authStatePayment.Store(authState, payment) } sessionRequest.PaymentMethod = paymentMethod // set buyer info buyer := &model.Buyer{ReferenceBuyerId: "yourBuyerId"} // replace with your orderId orderId := uuid.New().String() // set order Info order := &model.Order{ ReferenceOrderId: orderId, OrderDescription: "antom sdk testing order", OrderAmount: amount, Buyer: buyer, } sessionRequest.Order = order // replace with your notify url // or configure your notify url here: Notification URL sessionRequest.PaymentNotifyUrl = "http://www.yourNotifyUrl.com/payment/receivePaymentNotify" `] }, `server-Go-SDK-code2`), _jsx(AntomChunk, { language: `go`, steps: [`specify-the-payment-redirect-url`], chunks: [` // replace with your redirect url sessionRequest.PaymentRedirectUrl = "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId `] }, `server-Go-SDK-code3`), _jsx(AntomChunk, { language: `go`, steps: [``], chunks: [` startTime := time.Now() sessionRequestJson, _ := json.Marshal(sessionRequest) log.Printf("payment request: %s", sessionRequestJson) response, err := client.Execute(request) if err != nil { sendJSONResponse(w, http.StatusOK, ApiResponse{ Status: "error", PaymentRequestID: paymentRequestId, UserID: payment.UserID, Message: err.Error(), }) return } log.Printf("payment response: %+v", response) log.Printf("payment request cost time: %v ms\\n", time.Since(startTime).Milliseconds()) sendJSONResponse(w, http.StatusOK, ApiResponse{ Status: "success", PaymentRequestID: paymentRequestId, UserID: payment.UserID, Data: response, }) } `] }, `server-Go-SDK-other3`), _jsx(AntomChunk, { language: `go`, steps: [`receive-auth-notification`], chunks: [`func handleReceiveAuthNotify(w http.ResponseWriter, r *http.Request) { if r.Method != http.MethodPost { http.Error(w, "Method not allowed", http.StatusMethodNotAllowed) return } rawBody, err := io.ReadAll(r.Body) if err != nil { sendJSONResponse(w, http.StatusOK, response.Result{ ResultCode: "FAIL", ResultMessage: "fail.", ResultStatus: "F", }) return } notifyBody := string(rawBody) // retrieve the required parameters from http request requestURI := r.RequestURI requestMethod := r.Method // retrieve the required parameters from request header requestTime := r.Header.Get("request-time") clientID := r.Header.Get("client-id") signature := r.Header.Get("signature") // verify the signature of notification checkSignature, err := tools.CheckSignature(requestURI, requestMethod, clientID, requestTime, notifyBody, signature, AntomPublicKey) if err != nil || !checkSignature { sendJSONResponse(w, http.StatusOK, response.Result{ ResultCode: "FAIL", ResultMessage: "fail.", ResultStatus: "F", }) return } // deserialize the notification body var authNotify notify.AlipayAuthNotify if err := json.Unmarshal(rawBody, &authNotify); err != nil { sendJSONResponse(w, http.StatusOK, response.Result{ ResultCode: "FAIL", ResultMessage: "fail.", ResultStatus: "F", }) return } if authNotify.Result.ResultCode == "SUCCESS" && authNotify.AuthorizationNotifyType == "TOKEN_CREATED" { // save user's PaymentMethodType corresponding to accessToken if paymentValue, ok := authStatePayment.Load(authNotify.AuthState); ok { payment := paymentValue.(PaymentVO) if userValue, ok := users.Load(payment.UserID); ok { user := userValue.(*User) user.PaymentMethodTypeAccessToken[payment.PaymentMethodType] = authNotify.AccessToken sendJSONResponse(w, http.StatusOK, response.Result{ ResultCode: "SUCCESS", ResultMessage: "success.", ResultStatus: "S", }) return } } } sendJSONResponse(w, http.StatusOK, response.Result{ ResultCode: "SYSTEM_ERROR", ResultMessage: "system error.", ResultStatus: "F", }) } `] }, `server-Go-SDK-code4`), _jsx(AntomChunk, { language: `go`, steps: [`inquire-payment-result`], chunks: [`func handleInquiryPayment(w http.ResponseWriter, r *http.Request) { if r.Method != http.MethodPost { http.Error(w, "Method not allowed", http.StatusMethodNotAllowed) return } var requestMap map[string]string json.NewDecoder(r.Body).Decode(&requestMap) paymentRequestID := requestMap["paymentRequestId"] queryRequest, request := pay.NewAlipayPayQueryRequest() request.PaymentRequestId = paymentRequestID startTime := time.Now() log.Printf("inquiry payment request: %+v", request) response, err := client.Execute(queryRequest) if err != nil { sendJSONResponse(w, http.StatusOK, ApiResponse{ Status: "error", PaymentRequestID: paymentRequestID, Message: err.Error(), }) return } log.Printf("inquiry payment response: %+v", response) log.Printf("inquiry payment request cost time: %v ms\\n", time.Since(startTime).Milliseconds()) sendJSONResponse(w, http.StatusOK, ApiResponse{ Status: "success", PaymentRequestID: paymentRequestID, Data: response, }) } `] }, `server-Go-SDK-code5`), _jsx(AntomChunk, { language: `go`, steps: [``], chunks: [`func enableCORS(handler http.HandlerFunc) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Access-Control-Allow-Origin", "*") w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS") w.Header().Set("Access-Control-Allow-Headers", "Content-Type, X-Requested-With, Authorization") if r.Method == "OPTIONS" { w.WriteHeader(http.StatusOK) return } handler(w, r) } } func sendJSONResponse(w http.ResponseWriter, statusCode int, data interface{}) { w.Header().Set("Content-Type", "application/json") w.WriteHeader(statusCode) json.NewEncoder(w).Encode(data) } // User represents user information type User struct {`, ' UserID string `json:"userId"`', ' PhoneNumber string `json:"phoneNumber"`', ' PaymentMethodTypeAccessToken map[string]string `json:"paymentMethodTypeAccessToken"`', `} // PaymentVO represents payment request data type PaymentVO struct {`, ' UserID string `json:"userId"`', ' AmountValue string `json:"amountValue"`', ' Currency string `json:"currency"`', ' PaymentMethodType string `json:"paymentMethodType"`', `} // ApiResponse represents API response structure type ApiResponse struct {`, ' Status string `json:"status"`', ' PaymentRequestID string `json:"paymentRequestId"`', ' UserID string `json:"userId,omitempty"`', ' Message string `json:"message,omitempty"`', ' Data interface{} `json:"data,omitempty"`', `} `] }, `server-Go-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/server/.net/server.cs', when: { server: '.NET', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `dotnet`, filename: 'server.cs', downloadOnly: false, steps: [`get-integration-resources`, `create-a-payment-session`, `specify-the-payment-redirect-url`, `receive-auth-notification`, `inquire-payment-result`], children: [_jsx(AntomChunk, { language: `dotnet`, steps: [``], chunks: [`using System.Diagnostics; using Microsoft.AspNetCore; using Microsoft.AspNetCore.Mvc; using com.alipay.ams.api.request; using com.alipay.ams.api; using com.alipay.ams.api.entities; using com.alipay.ams.api.request.notify; using com.alipay.ams.api.request.pay; using com.alipay.ams.api.response.pay; using com.alipay.ams.util; using Newtonsoft.Json; using NMoneys; namespace antom_online_payment_sample_dotnet.easysafepay.sdk { /** * sample payment server using Antom SDK integration mode */ public class Server {`] }, `server-.NET-SDK-other1`), _jsx(AntomChunk, { language: `dotnet`, steps: [`get-integration-resources`], chunks: [` /** * replace with your client id * find your client id here: quickStart */ public static readonly string CLIENT_ID = "your_client_id"; /** * replace with your antom public key (used to verify signature) * find your antom public key here: quickStart */ public static readonly string ANTOM_PUBLIC_KEY = "antom_public_key"; /** * replace with your private key (used to sign) * please ensure the secure storage of your private key to prevent leakage */ public static readonly string MERCHANT_PRIVATE_KEY = "your_private_key"; public static DefaultAlipayClient defaultAlipayClient = new DefaultAlipayClient("https://open-sea-global.alipay.com", CLIENT_ID, MERCHANT_PRIVATE_KEY, ANTOM_PUBLIC_KEY); `] }, `server-.NET-SDK-code1`), _jsx(AntomChunk, { language: `dotnet`, steps: [``], chunks: [` // Save the mapping between authState and payment information public static readonly Dictionary authStatePayment = new Dictionary(); // Save the mapping between userId and user info public static readonly Dictionary users = new Dictionary(); static Server() { users.Add("antom-easysafepay", new User("antom-easysafepay", "852-91234567")); } public static void Main(string[] args) { WebHost.CreateDefaultBuilder(args) .UseUrls("http://0.0.0.0:8080") .UseWebRoot("client") .UseStartup() .Build() .Run(); } } public class Startup { public void ConfigureServices(IServiceCollection services) { services.AddMvc().AddNewtonsoftJson(); // Add the Cors service services.AddCors(options => { options.AddPolicy("AllowAllOrigins", builder => { builder.AllowAnyOrigin(); builder.AllowAnyMethod(); builder.AllowAnyHeader(); }); }); } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) app.UseDeveloperExceptionPage(); app.UseCors("AllowAllOrigins"); app.UseRouting(); app.UseStaticFiles(); app.UseEndpoints(endpoints => endpoints.MapControllers()); } } [ApiController] [Produces("application/json")] [ApiConventionType(typeof(DefaultApiConventions))] public class PaymentController : ControllerBase {`] }, `server-.NET-SDK-other2`), _jsx(AntomChunk, { language: `dotnet`, steps: [`create-a-payment-session`], chunks: [` [HttpPost("payment/createSession")] public IActionResult CreatePaymentSession([FromBody] PaymentVO payment) { var alipayPaymentSessionRequest = new AlipayPaymentSessionRequest(); alipayPaymentSessionRequest.ProductCode = ProductCodeType.AGREEMENT_PAYMENT; alipayPaymentSessionRequest.ProductScene = "EASY_PAY"; // replace with your paymentRequestId var paymentRequestId = Guid.NewGuid().ToString(); alipayPaymentSessionRequest.PaymentRequestId = paymentRequestId; // convert amount unit(in practice, amount should be calculated on your serverside) // For details, please refer to: Usage rules of the Amount object var minorIntegralAmount = new Money(decimal.Parse(payment.AmountValue), Currency.Get(payment.Currency)) .MinorIntegralAmount; // set amount var amount = new Amount() { Currency = payment.Currency, Value = minorIntegralAmount.ToString() }; alipayPaymentSessionRequest.PaymentAmount = amount; // set settlement strategy // replace with your existing settlement currency var settlementStrategy = new SettlementStrategy() { SettlementCurrency = "USD" }; alipayPaymentSessionRequest.SettlementStrategy = settlementStrategy; var loginUser = Server.users[payment.UserId]; // set paymentMethod var paymentMethod = new PaymentMethod(payment.PaymentMethodType); var tryGetValue = loginUser.PaymentMethodTypeAccessToken.TryGetValue(payment.PaymentMethodType,out var accessToken); if (tryGetValue) { // user has authorized accessToken = loginUser.PaymentMethodTypeAccessToken[payment.PaymentMethodType]; paymentMethod.PaymentMethodId = accessToken; } else { // set agreementInfo // replace with your authState var authState = Guid.NewGuid().ToString(); // The login ID that the user used to register in the payment method client. The login ID can be the user's email address or phone number. // Specify this parameter to free users from manually entering their login IDs. var userLoginId = loginUser.PhoneNumber; var agreementInfo = new AgreementInfo() { AuthState = authState, UserLoginId = userLoginId }; alipayPaymentSessionRequest.AgreementInfo = agreementInfo; // save the paymentMethodType corresponding to the authState Server.authStatePayment[authState] = payment; } alipayPaymentSessionRequest.PaymentMethod = paymentMethod; // set buyer info var buyer = new Buyer() { ReferenceBuyerId = "yourBuyerId" }; // replace with your orderId var orderId = Guid.NewGuid().ToString(); // set order Info alipayPaymentSessionRequest.Order = new Order() { ReferenceOrderId = orderId, OrderDescription = "antom sdk testing order", OrderAmount = amount, Buyer = buyer }; // replace with your notify url // or configure your notify url here: Notification URL alipayPaymentSessionRequest.PaymentNotifyUrl = "http://www.yourNotifyUrl.com/payment/receivePaymentNotify"; `] }, `server-.NET-SDK-code2`), _jsx(AntomChunk, { language: `dotnet`, steps: [`specify-the-payment-redirect-url`], chunks: [` // replace with your redirect url alipayPaymentSessionRequest.PaymentRedirectUrl = "http://localhost:8080/index.html?paymentRequestId=" + paymentRequestId; `] }, `server-.NET-SDK-code3`), _jsx(AntomChunk, { language: `dotnet`, steps: [``], chunks: [` try { var stopwatch = new Stopwatch(); stopwatch.Start(); Console.WriteLine("payment request: " + JsonConvert.SerializeObject(alipayPaymentSessionRequest, Formatting.Indented)); var alipayPaymentSessionResponse = Server.defaultAlipayClient.Execute(alipayPaymentSessionRequest); Console.WriteLine("payment response: " + JsonConvert.SerializeObject(alipayPaymentSessionResponse, Formatting.Indented)); stopwatch.Stop(); Console.WriteLine("payment request cost time: " + stopwatch.ElapsedMilliseconds + "ms\\n"); return Ok(new ApiResponse(paymentRequestId, payment.UserId, alipayPaymentSessionResponse)); } catch (Exception e) { return Ok(new ApiResponse(paymentRequestId, payment.UserId, e)); } } `] }, `server-.NET-SDK-other3`), _jsx(AntomChunk, { language: `dotnet`, steps: [`receive-auth-notification`], chunks: [` [HttpPost("authorizations/receiveAuthNotify")] public async Task ReceiveAuthNotify() { // retrieve the required parameters from http request string requestUri = HttpContext.Request.Path; string notifyBody; using (var reader = new StreamReader(Request.Body)) { notifyBody = await reader.ReadToEndAsync(); } // retrieve the required parameters from request header var requestTime = HttpContext.Request.Headers["request-time"]; var clientId = HttpContext.Request.Headers["client-id"]; var signature = HttpContext.Request.Headers["signature"]; try { // verify the signature of notification var realSignature = ""; if (string.IsNullOrWhiteSpace(signature)) { throw new Exception("empty notify signature"); } var parts = signature.ToString().Split("signature="); if (parts.Length > 1) { realSignature = parts[1]; } var verifyResult = SignatureUtil.verify(requestUri, clientId, requestTime, Server.ANTOM_PUBLIC_KEY, notifyBody, realSignature); if (!verifyResult) { throw new Exception("Invalid notify signature"); } // deserialize the notification body var authNotify = JsonConvert.DeserializeObject(notifyBody); if (authNotify != null && "SUCCESS".Equals(authNotify.Result.ResultCode) && "TOKEN_CREATED".Equals(authNotify.AuthorizationNotifyType)) { // save user's PaymentMethodType corresponding to accessToken var payment = Server.authStatePayment[authNotify.AuthState]; var user = Server.users[payment.UserId]; user.PaymentMethodTypeAccessToken[payment.PaymentMethodType] = authNotify.AccessToken; return Ok(new Result() { ResultCode = "SUCCESS", ResultMessage = "success.", ResultStatus = ResultStatusType.S }); } } catch (Exception e) { return Ok(new Result() { ResultCode = "FAIL", ResultMessage = "fail.", ResultStatus = ResultStatusType.F }); } return Ok(new Result() { ResultCode = "SYSTEM_ERROR", ResultMessage = "system error.", ResultStatus = ResultStatusType.F }); } `] }, `server-.NET-SDK-code4`), _jsx(AntomChunk, { language: `dotnet`, steps: [`inquire-payment-result`], chunks: [` [HttpPost("payment/inquiryPayment")] public IActionResult InquiryPayment([FromBody] Dictionary map) { map.TryGetValue("paymentRequestId", out var paymentRequestId); var alipayPayQueryRequest = new PaymentInquiryRequest(); alipayPayQueryRequest.PaymentRequestId = paymentRequestId; try { var stopwatch = new Stopwatch(); stopwatch.Start(); Console.WriteLine("inquiry payment request: " + JsonConvert.SerializeObject(alipayPayQueryRequest, Formatting.Indented)); var alipayPayQueryResponse = Server.defaultAlipayClient.Execute(alipayPayQueryRequest); Console.WriteLine("inquiry payment response: " + JsonConvert.SerializeObject(alipayPayQueryResponse, Formatting.Indented)); stopwatch.Stop(); Console.WriteLine("inquiry payment request cost time: " + stopwatch.ElapsedMilliseconds + "ms\\n"); return Ok(new ApiResponse(paymentRequestId, "", alipayPayQueryResponse)); } catch (Exception e) { return Ok(new ApiResponse(paymentRequestId, "", e)); } }`] }, `server-.NET-SDK-code5`), _jsx(AntomChunk, { language: `dotnet`, steps: [``], chunks: [` } public class User { public string UserId { get; set; } public string PhoneNumber { get; set; } public Dictionary PaymentMethodTypeAccessToken { get; set; } public User(string userId, string phoneNumber) { UserId = userId; PhoneNumber = phoneNumber; PaymentMethodTypeAccessToken = new Dictionary(); } } public class PaymentVO { public string UserId { get; set; } public string AmountValue { get; set; } public string Currency { get; set; } public string PaymentMethodType { get; set; } } public class ApiResponse { public string Status { get; set; } = "success"; public string PaymentRequestId { get; set; } public string UserId { get; set; } public string Message { get; set; } public object Data { get; set; } public ApiResponse(string paymentRequestId, string userId, object data) { PaymentRequestId = paymentRequestId; UserId = userId; Data = data; } public ApiResponse(string paymentRequestId, string userId, Exception e) { PaymentRequestId = paymentRequestId; UserId = userId; Status = "error"; Message = e.Message; } } } `] }, `server-.NET-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.html', when: { client: 'HTML', server: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `html`, filename: 'src/main/resources/static/index.html', downloadOnly: false, steps: [`build-the-easysafepay-page`], children: _jsx(AntomChunk, { language: `html`, steps: [`build-the-easysafepay-page`], chunks: [` Antom Demo Easysafepay

Easysafepay Demo

Choose your payment method

`] }, `Web-HTML-SDK-code1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.js', when: { client: 'HTML', server: 'Java', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `javascript`, filename: 'src/main/resources/static/index.js', downloadOnly: false, steps: [`initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`/** * The integration method of the Antom SDK. */ window.selectedPaymentOptionId = "ALIPAY_HK"; window.amount = { currency: "HKD", value: "980.80", mul: 1 }; const paymentOptions = [ { label: "AliPay HK", value: "ALIPAY_HK", icon: "https://gw.alipay.com/icon/medium/default/ALIPAY_HK.svg", } ]; const currencyMap = { 'ALIPAY_HK': { currency: 'HKD', value: '980.80', } } // Step 1: Create an SDK instance.`] }, `Web-HTML-SDK-other1`), _jsx(AntomChunk, { language: `javascript`, steps: [`initialize-instantiate-the-sdk`], chunks: [`const easyPayApp = new window.AMSEasyPay({ environment: "sandbox", locale: "en_US", onEventCallback, }); `] }, `Web-HTML-SDK-code1`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 2: Create onEventCallback handler. function onEventCallback({ code }) { switch (code) { case 'SDK_PAYMENT_CANCEL': console.log( 'The buyer canceled the payment (the buyer exited the payment page without submitting the order). You can re-invoke the SDK using paymentSessionData within its validity period; If it has expired, you need to initiate a new createPaymentSession (EasySafePay) request.' ); break; case 'SDK_CALL_URL_SUCCESS': console.log('Successfully opened the payment method app or redirected to the merchant page.'); break; case 'SDK_LAUNCH_PAYMENT_APP_ERROR': console.log('Failed to redirect to the checkout page of the payment method, or failed to redirect to the merchant page. Check whether the paymentRedirectUrl parameter is correctly passed when calling the createPaymentSession (EasySafePay) request. Web/WAP scenarios rarely experience redirection exceptions. However, in the event of any exceptions, it is recommended to verify the redirection link.'); break; case 'SDK_PAYMENT_SUCCESSFUL': console.log('The wallet has successfully processed the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; case 'SDK_PAYMENT_FAIL': console.log('The wallet failed to process the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; default: console.log(code); } }; // Step 3: Create the EasySafePay payment rendering component.`] }, `Web-HTML-SDK-other2`), _jsx(AntomChunk, { language: `javascript`, steps: [`invoke-the-sdk`], chunks: [`async function createPopupEasyPay(paymentSessionData) { try { await easyPayApp.createComponent({ sessionData: paymentSessionData, notRedirectAfterComplete: false, }); } catch (error) { showAlert(error.code, error.message || "Invalid response format", "error"); } } `] }, `Web-HTML-SDK-code3`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 4: Get payment session data from the endpoint. async function handleSubmit() { try { const consultResponse = await getPaymentSessionData(); if ( consultResponse && consultResponse?.data?.result?.resultStatus === "S" && consultResponse?.data?.paymentSessionData !== null ) { await createPopupEasyPay(consultResponse.data.paymentSessionData); } else if (consultResponse?.paymentRequestId) { console.error(consultResponse); } } catch (error) { showAlert("Error", error.message || "Failed to process payment", "error"); } } // Step 5: Call the createPaymentSession API.`] }, `Web-HTML-SDK-other3`), _jsx(AntomChunk, { language: `javascript`, steps: [`get-a-payment-session`], chunks: [`async function getPaymentSessionData() { setBtnLoading(true); if (!window.selectedPaymentOptionId) { showAlert("Warning", "Please select a payment method!", "warning"); setBtnLoading(false); return null; } // Define the URL for your backend endpoint. const url = "http://localhost:8080/payment/createSession"; try { const response = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ // In practice, amount should be calculated on your server side. amountValue: window.amount.value, currency: window.amount.currency, paymentMethodType: window.selectedPaymentOptionId, // Replace with the specific userId. userId: 'antom-easysafepay' }), }); if (!response.ok) { throw new Error("HTTP error! Status: " + response.status); } const res = await response.json(); if (res.status === "success") return res; throw new Error(res.message || "Invalid response format"); } catch (error) { showAlert( "Error", error.message || "Failed to fetch payment session data", "error" ); return null; } finally { setBtnLoading(false); } } `] }, `Web-HTML-SDK-code2`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 6: Call the inquiryPayment API to get the payment status.`] }, `Web-HTML-SDK-other4`), _jsx(AntomChunk, { language: `javascript`, steps: [`display-the-payment-result`], chunks: [`async function inquiryPayment(paymentRequestId) { // Define the URL for your backend endpoint const baseUrl = "http://localhost:8080/payment/inquiryPayment"; const config = { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ paymentRequestId }), }; const response = await fetch(baseUrl, config); if (!response.ok) throw new Error("Network response was not ok"); const res = await response.json(); return res.status === "success" ? res.data.paymentStatus : "ERROR"; } `] }, `Web-HTML-SDK-code4`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 7: Create polling mechanism to retrieve the payment result. async function pollPaymentResult() { const paymentRequestId = new URLSearchParams(window.location.search).get( "paymentRequestId" ); if (!paymentRequestId) return; const poll = async () => { let status = "PROCESSING"; let retries = 0; const maxRetries = 5; while (retries < maxRetries) { try { const statusResult = await inquiryPayment(paymentRequestId); status = statusResult ?? "ERROR"; } catch (error) { status = "ERROR"; } retries += 1; if (status === "SUCCESS" || retries === maxRetries) { return handlePaymentStatus(status); } await new Promise((resolve) => setTimeout(resolve, 2000)); } }; poll(); } // Step 8: Bind handleSubmit function to submit button. document.getElementById("submit").addEventListener("click", handleSubmit); // Step 9: Render payment options & check run polling result. document.addEventListener("DOMContentLoaded", () => { // Optional Step: Preload SDK resources window.AMSEasyPay.preload(); appendPaymentOptions(paymentOptions); pollPaymentResult(); }); // ------- User Interaction Section ------- function appendPaymentOptions(options) { const paymentOptionsContainer = document.getElementById("checkout-box"); paymentOptionsContainer.innerHTML = ""; const frag = document.createDocumentFragment(); options.forEach((option) => { const label = document.createElement("label"); label.className = "payment-option"; const input = document.createElement("input"); input.type = "radio"; input.className = "radio-input"; input.name = "radio"; input.value = option.value; input.checked = option.value === window.selectedPaymentOptionId; if (input.checked) { label.classList.add("selected"); } input.addEventListener("change", selectPaymentOption); const span = document.createElement("span"); span.className = "radio-button"; const icon = document.createElement("img"); icon.src = option.icon; icon.className = "payment-icon"; const textNode = document.createTextNode(option.label); label.append(input, span, icon, textNode); frag.appendChild(label); }); paymentOptionsContainer.appendChild(frag); } function selectPaymentOption(event) { const targetValue = event.target.value; if (targetValue) { document .querySelectorAll(".payment-option") .forEach((label) => label.classList.remove("selected")); const selectedLabel = event.target.parentElement; selectedLabel.classList.add("selected"); window.selectedPaymentOptionId = targetValue; window.amount = { ...window.amount, currency: currencyMap[targetValue].currency, value: currencyMap[targetValue].value, } const submitElement = document.getElementById("submit");`, ' submitElement.innerText = `Pay \${window.amount.currency} \${window.amount.value}`;', ` } } function handlePaymentStatus(status) { switch (status) { case "SUCCESS": showPaymentResult( "Payment Successful", "Thank you for your payment! We will ship out your order as soon as possible.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ", "#e5f7f1", "#b7e9d9" ); break; case "FAIL": showPaymentResult( "Payment Failed", "Please return to the merchant order page and resubmit your payment.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", "rgba(255, 91, 77, 0.10)", "rgba(255, 91, 77, 0.20)" ); break; case "ERROR": showPaymentResult( "Error", "An error occurred while checking the payment status. Please try again or contact support.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", "rgba(255, 91, 77, 0.10)", "rgba(255, 91, 77, 0.20)" ); break; default: showPaymentResult( "Payment Processing", "Please return to the merchant order page and resubmit your payment.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ", "rgba(255, 159, 26, 0.10)", "rgba(255, 159, 26, 0.20) " ); } } function setBtnLoading(isLoading) { const submitElement = document.getElementById("submit"); submitElement.disabled = isLoading; submitElement.classList.toggle("disabled", isLoading); } function showPaymentResult(title, message, icon, bgColor, borderColor) { const messageContainer = document.querySelector("#result-container"); if (!messageContainer) return; messageContainer.classList.remove("hidden"); messageContainer.style.backgroundColor = bgColor; messageContainer.style.borderColor = borderColor; document.getElementById("message").innerText = title; document.getElementById("content").innerText = message; document.getElementById("resultIcon").setAttribute("src", icon); setTimeout(() => { messageContainer.classList.add("hidden"); messageContainer.style.backgroundColor = ""; messageContainer.style.borderColor = ""; document.getElementById("message").innerText = ""; document.getElementById("content").innerText = ""; document.getElementById("resultIcon").setAttribute("src", ""); window.location.href = "./index.html"; }, 8000); } function showAlert(title, subTitle, type) { const icons = { warning: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ", error: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", success: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ", }; const containerDesktop = document.getElementById("container-desktop"); const mockup = document.getElementById("mockup"); const alertIcon = document.getElementById("alert-icon"); const containerTitle = document.getElementById("container-title"); const containerSubTitle = document.getElementById("container-subTitle"); containerDesktop.style.display = "block"; mockup.style.display = "block"; alertIcon.src = icons[type] || ""; containerTitle.textContent = title || ""; containerSubTitle.textContent = subTitle || ""; alertIcon.style.display = icons[type] ? "block" : "none"; containerTitle.style.display = title ? "block" : "none"; containerSubTitle.style.display = subTitle ? "block" : "none"; } function closeAlert() { document.getElementById("container-desktop").style.display = "none"; document.getElementById("mockup").style.display = "none"; } document.getElementById("alert-ok-btn").addEventListener("click", closeAlert); `] }, `Web-HTML-SDK-other5`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.css', when: { client: 'HTML', server: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'src/main/resources/static/index.css', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`body { margin: 0; padding: 0; font-family: 'PingFang SC'; display: flex; flex-direction: column; height: 100vh; margin: 0 auto; } .antom-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } header { width: 100%; height: 72px; background: #fdfdfd; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .header-content { margin: 0 auto; width: 70%; height: 100%; display: flex; align-items: center; justify-content: flex-start; } .header-content-img { width: 120px; } .header-content .subtitle { margin-left: 28px; color: #bcbcbc; font-size: 16px; font-style: normal; font-weight: 500; line-height: 24px; } .content { display: flex; flex-direction: column; position: relative; overflow: hidden; margin-top: 82px; height: 800px; flex-shrink: 0; border-radius: 40px; background: #fff; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .headerContent { display: flex; align-items: center; justify-content: flex-start; } .headerContent .logo { margin: 0 10px; } .headerContent .testDemo { width: 62px; height: 16px; display: flex; align-items: center; justify-content: center; border-radius: 4px; background: rgba(0, 0, 0, 0.1); color: rgba(0, 0, 0, 0.4); font-size: 8px; font-weight: 400; } .checkout-container { margin: 0 auto; width: 100%; display: flex; flex-direction: column; flex-grow: 1; width: 660px; height: 100%; padding: 162px 64px 76px 56px; box-sizing: border-box; } p { display: inline-flex; align-items: center; gap: 10px; color: #2a3a52; } .payment-option { border: 2px solid #000; padding: 10px; margin-bottom: 20px; display: none; cursor: pointer; } .payment-option.selected { border-color: #1650ff; } .show { display: block; } .submit { width: 100%; height: 56px; border-radius: 12px; background: #1650ff; color: #fff; border: none; text-decoration: none; cursor: pointer; font-size: 16px; display: block; margin-top: 32px; } .radio-group { display: flex; flex-direction: column; } .radio-group label { display: flex; align-items: center; margin-bottom: 8px; padding: 8px 16px; border: 1px solid #ebebeb; background: #fff; border-radius: 12px; color: #2a3a52; font-size: 16px; font-weight: 400; line-height: 24px; } .radio-group label.show { display: flex; } .radio-input { display: none; } .radio-button { width: 14px; height: 14px; border: 1px solid #abb9cc; margin-right: 8px; border-radius: 50%; } .radio-input:checked + .radio-button { border: 4px solid #1650ff; width: 8px; height: 8px; } .payment-icon { vertical-align: middle; display: flex; width: 32px; height: 32px; margin: 0 12px; padding: 4px 4.001px 3.996px 3.999px; justify-content: center; align-items: center; border-radius: 8px; border: 0.5px solid #f5f5f5; background: #fcfcfc; } .disabled { cursor: not-allowed; opacity: 0.5; pointer-events: none; } .hidden { display: none; } #result-container { display: flex; flex-direction: column; margin-top: 14px; align-items: flex-start; border-radius: 12px; border: 1px solid rgba(0, 0, 0, 0); padding: 12px 16px; color: #2a3a52; font-size: 13px; font-weight: 500; line-height: 20px; } .result-title { display: flex; align-items: center; } .result-title img { width: 20px; margin-right: 12px; } #content { color: #7c8ca3; text-align: center; font-size: 12px; font-weight: 400; line-height: 18px; margin-top: 8px; padding-left: 32px; } .mockup { display: none; z-index: 1000; width: 100vw; height: 100vh; position: fixed; top: 0px; left: 0px; background: rgba(0, 0, 0, 0.6); } .container-desktop { display: none; width: 370px; height: 248px; position: fixed; top: 50%; left: 50%; z-index: 1001; border-radius: 12px; overflow: hidden; transform-origin: 50% 50%; transform: translate(-50%, -50%); box-shadow: 0px 0px 8px 0px rgba(0, 0, 0, 0.1); padding: 40px 0px 24px 0px; background-color: #fff; } @keyframes container-zoom-in { 0% { transform: translate(-50%, -50%) scale(0.4); opacity: 0; } 80% { opacity: 1; } 100% { opacity: 1; transform: translate(-50%, -50%) scale(1); } } .desktop-animation { animation: container-zoom-in 0.3s ease-in-out; animation-fill-mode: forwards; } .container-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } .container-content img { width: 64px; height: 64px; } .container-title { color: var(--Content-Primary, #2a3a52); text-align: center; font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .container-subTitle { color: #7c8ca3; text-align: center; font-size: 14px; font-weight: 400; line-height: 20px; margin-top: 24px; } .container-btn { display: flex; width: 338px; height: 48px; padding: 0px 24px; justify-content: center; align-items: center; border-radius: var(---Button, 12px); background: var(--Action-Normal, #1650ff); border: none; cursor: pointer; color: var(--Content-Quaternary, #fff); font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .footer { display: flex; justify-content: center; margin-top: 20px; color: #bcbcbc; font-size: 16px; font-weight: 500; line-height: 24px; } .gotoTest { color: #1650ff; margin: 0 4px; text-decoration: none; } `] }, `Web-HTML-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.html', when: { client: 'HTML', integration_type: 'SDK' }, unless: { server: 'Java' }, children: _jsx(AntomFile, { language: `html`, filename: 'client/index.html', downloadOnly: false, steps: [`build-the-easysafepay-page`], children: _jsx(AntomChunk, { language: `html`, steps: [`build-the-easysafepay-page`], chunks: [` Antom Demo Easysafepay

Easysafepay Demo

Choose your payment method

`] }, `Web-HTML-SDK-code1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.js', when: { client: 'HTML', integration_type: 'SDK' }, unless: { server: 'Java' }, children: _jsxs(AntomFile, { language: `javascript`, filename: 'client/index.js', downloadOnly: false, steps: [`initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`/** * The integration method of the Antom SDK. */ window.selectedPaymentOptionId = "ALIPAY_HK"; window.amount = { currency: "HKD", value: "980.80", mul: 1 }; const paymentOptions = [ { label: "AliPay HK", value: "ALIPAY_HK", icon: "https://gw.alipay.com/icon/medium/default/ALIPAY_HK.svg", } ]; const currencyMap = { 'ALIPAY_HK': { currency: 'HKD', value: '980.80', } } // Step 1: Create an SDK instance.`] }, `Web-HTML-SDK-other1`), _jsx(AntomChunk, { language: `javascript`, steps: [`initialize-instantiate-the-sdk`], chunks: [`const easyPayApp = new window.AMSEasyPay({ environment: "sandbox", locale: "en_US", onEventCallback, }); `] }, `Web-HTML-SDK-code1`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 2: Create onEventCallback handler. function onEventCallback({ code }) { switch (code) { case 'SDK_PAYMENT_CANCEL': console.log( 'The buyer canceled the payment (the buyer exited the payment page without submitting the order). You can re-invoke the SDK using paymentSessionData within its validity period; If it has expired, you need to initiate a new createPaymentSession (EasySafePay) request.' ); break; case 'SDK_CALL_URL_SUCCESS': console.log('Successfully opened the payment method app or redirected to the merchant page.'); break; case 'SDK_LAUNCH_PAYMENT_APP_ERROR': console.log('Failed to redirect to the checkout page of the payment method, or failed to redirect to the merchant page. Check whether the paymentRedirectUrl parameter is correctly passed when calling the createPaymentSession (EasySafePay) request. Web/WAP scenarios rarely experience redirection exceptions. However, in the event of any exceptions, it is recommended to verify the redirection link.'); break; case 'SDK_PAYMENT_SUCCESSFUL': console.log('The wallet has successfully processed the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; case 'SDK_PAYMENT_FAIL': console.log('The wallet failed to process the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; default: console.log(code); } }; // Step 3: Create the EasySafePay payment rendering component.`] }, `Web-HTML-SDK-other2`), _jsx(AntomChunk, { language: `javascript`, steps: [`invoke-the-sdk`], chunks: [`async function createPopupEasyPay(paymentSessionData) { try { await easyPayApp.createComponent({ sessionData: paymentSessionData, notRedirectAfterComplete: false, }); } catch (error) { showAlert(error.code, error.message || "Invalid response format", "error"); } } `] }, `Web-HTML-SDK-code3`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 4: Get payment session data from the endpoint. async function handleSubmit() { try { const consultResponse = await getPaymentSessionData(); if ( consultResponse && consultResponse?.data?.result?.resultStatus === "S" && consultResponse?.data?.paymentSessionData !== null ) { await createPopupEasyPay(consultResponse.data.paymentSessionData); } else if (consultResponse?.paymentRequestId) { console.error(consultResponse); } } catch (error) { showAlert("Error", error.message || "Failed to process payment", "error"); } } // Step 5: Call the createPaymentSession API.`] }, `Web-HTML-SDK-other3`), _jsx(AntomChunk, { language: `javascript`, steps: [`get-a-payment-session`], chunks: [`async function getPaymentSessionData() { setBtnLoading(true); if (!window.selectedPaymentOptionId) { showAlert("Warning", "Please select a payment method!", "warning"); setBtnLoading(false); return null; } // Define the URL for your backend endpoint. const url = "http://localhost:8080/payment/createSession"; try { const response = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ // In practice, amount should be calculated on your server side. amountValue: window.amount.value, currency: window.amount.currency, paymentMethodType: window.selectedPaymentOptionId, // Replace with the specific userId. userId: 'antom-easysafepay' }), }); if (!response.ok) { throw new Error("HTTP error! Status: " + response.status); } const res = await response.json(); if (res.status === "success") return res; throw new Error(res.message || "Invalid response format"); } catch (error) { showAlert( "Error", error.message || "Failed to fetch payment session data", "error" ); return null; } finally { setBtnLoading(false); } } `] }, `Web-HTML-SDK-code2`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 6: Call the inquiryPayment API to get the payment status.`] }, `Web-HTML-SDK-other4`), _jsx(AntomChunk, { language: `javascript`, steps: [`display-the-payment-result`], chunks: [`async function inquiryPayment(paymentRequestId) { // Define the URL for your backend endpoint const baseUrl = "http://localhost:8080/payment/inquiryPayment"; const config = { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ paymentRequestId }), }; const response = await fetch(baseUrl, config); if (!response.ok) throw new Error("Network response was not ok"); const res = await response.json(); return res.status === "success" ? res.data.paymentStatus : "ERROR"; } `] }, `Web-HTML-SDK-code4`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`// Step 7: Create polling mechanism to retrieve the payment result. async function pollPaymentResult() { const paymentRequestId = new URLSearchParams(window.location.search).get( "paymentRequestId" ); if (!paymentRequestId) return; const poll = async () => { let status = "PROCESSING"; let retries = 0; const maxRetries = 5; while (retries < maxRetries) { try { const statusResult = await inquiryPayment(paymentRequestId); status = statusResult ?? "ERROR"; } catch (error) { status = "ERROR"; } retries += 1; if (status === "SUCCESS" || retries === maxRetries) { return handlePaymentStatus(status); } await new Promise((resolve) => setTimeout(resolve, 2000)); } }; poll(); } // Step 8: Bind handleSubmit function to submit button. document.getElementById("submit").addEventListener("click", handleSubmit); // Step 9: Render payment options & check run polling result. document.addEventListener("DOMContentLoaded", () => { // Optional Step: Preload SDK resources window.AMSEasyPay.preload(); appendPaymentOptions(paymentOptions); pollPaymentResult(); }); // ------- User Interaction Section ------- function appendPaymentOptions(options) { const paymentOptionsContainer = document.getElementById("checkout-box"); paymentOptionsContainer.innerHTML = ""; const frag = document.createDocumentFragment(); options.forEach((option) => { const label = document.createElement("label"); label.className = "payment-option"; const input = document.createElement("input"); input.type = "radio"; input.className = "radio-input"; input.name = "radio"; input.value = option.value; input.checked = option.value === window.selectedPaymentOptionId; if (input.checked) { label.classList.add("selected"); } input.addEventListener("change", selectPaymentOption); const span = document.createElement("span"); span.className = "radio-button"; const icon = document.createElement("img"); icon.src = option.icon; icon.className = "payment-icon"; const textNode = document.createTextNode(option.label); label.append(input, span, icon, textNode); frag.appendChild(label); }); paymentOptionsContainer.appendChild(frag); } function selectPaymentOption(event) { const targetValue = event.target.value; if (targetValue) { document .querySelectorAll(".payment-option") .forEach((label) => label.classList.remove("selected")); const selectedLabel = event.target.parentElement; selectedLabel.classList.add("selected"); window.selectedPaymentOptionId = targetValue; window.amount = { ...window.amount, currency: currencyMap[targetValue].currency, value: currencyMap[targetValue].value, } const submitElement = document.getElementById("submit");`, ' submitElement.innerText = `Pay \${window.amount.currency} \${window.amount.value}`;', ` } } function handlePaymentStatus(status) { switch (status) { case "SUCCESS": showPaymentResult( "Payment Successful", "Thank you for your payment! We will ship out your order as soon as possible.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ", "#e5f7f1", "#b7e9d9" ); break; case "FAIL": showPaymentResult( "Payment Failed", "Please return to the merchant order page and resubmit your payment.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", "rgba(255, 91, 77, 0.10)", "rgba(255, 91, 77, 0.20)" ); break; case "ERROR": showPaymentResult( "Error", "An error occurred while checking the payment status. Please try again or contact support.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", "rgba(255, 91, 77, 0.10)", "rgba(255, 91, 77, 0.20)" ); break; default: showPaymentResult( "Payment Processing", "Please return to the merchant order page and resubmit your payment.", "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ", "rgba(255, 159, 26, 0.10)", "rgba(255, 159, 26, 0.20) " ); } } function setBtnLoading(isLoading) { const submitElement = document.getElementById("submit"); submitElement.disabled = isLoading; submitElement.classList.toggle("disabled", isLoading); } function showPaymentResult(title, message, icon, bgColor, borderColor) { const messageContainer = document.querySelector("#result-container"); if (!messageContainer) return; messageContainer.classList.remove("hidden"); messageContainer.style.backgroundColor = bgColor; messageContainer.style.borderColor = borderColor; document.getElementById("message").innerText = title; document.getElementById("content").innerText = message; document.getElementById("resultIcon").setAttribute("src", icon); setTimeout(() => { messageContainer.classList.add("hidden"); messageContainer.style.backgroundColor = ""; messageContainer.style.borderColor = ""; document.getElementById("message").innerText = ""; document.getElementById("content").innerText = ""; document.getElementById("resultIcon").setAttribute("src", ""); window.location.href = "./index.html"; }, 8000); } function showAlert(title, subTitle, type) { const icons = { warning: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ", error: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ", success: "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ", }; const containerDesktop = document.getElementById("container-desktop"); const mockup = document.getElementById("mockup"); const alertIcon = document.getElementById("alert-icon"); const containerTitle = document.getElementById("container-title"); const containerSubTitle = document.getElementById("container-subTitle"); containerDesktop.style.display = "block"; mockup.style.display = "block"; alertIcon.src = icons[type] || ""; containerTitle.textContent = title || ""; containerSubTitle.textContent = subTitle || ""; alertIcon.style.display = icons[type] ? "block" : "none"; containerTitle.style.display = title ? "block" : "none"; containerSubTitle.style.display = subTitle ? "block" : "none"; } function closeAlert() { document.getElementById("container-desktop").style.display = "none"; document.getElementById("mockup").style.display = "none"; } document.getElementById("alert-ok-btn").addEventListener("click", closeAlert); `] }, `Web-HTML-SDK-other5`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/html/index.css', when: { client: 'HTML', integration_type: 'SDK' }, unless: { server: 'Java' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/index.css', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`body { margin: 0; padding: 0; font-family: 'PingFang SC'; display: flex; flex-direction: column; height: 100vh; margin: 0 auto; } .antom-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } header { width: 100%; height: 72px; background: #fdfdfd; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .header-content { margin: 0 auto; width: 70%; height: 100%; display: flex; align-items: center; justify-content: flex-start; } .header-content-img { width: 120px; } .header-content .subtitle { margin-left: 28px; color: #bcbcbc; font-size: 16px; font-style: normal; font-weight: 500; line-height: 24px; } .content { display: flex; flex-direction: column; position: relative; overflow: hidden; margin-top: 82px; height: 800px; flex-shrink: 0; border-radius: 40px; background: #fff; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .headerContent { display: flex; align-items: center; justify-content: flex-start; } .headerContent .logo { margin: 0 10px; } .headerContent .testDemo { width: 62px; height: 16px; display: flex; align-items: center; justify-content: center; border-radius: 4px; background: rgba(0, 0, 0, 0.1); color: rgba(0, 0, 0, 0.4); font-size: 8px; font-weight: 400; } .checkout-container { margin: 0 auto; width: 100%; display: flex; flex-direction: column; flex-grow: 1; width: 660px; height: 100%; padding: 162px 64px 76px 56px; box-sizing: border-box; } p { display: inline-flex; align-items: center; gap: 10px; color: #2a3a52; } .payment-option { border: 2px solid #000; padding: 10px; margin-bottom: 20px; display: none; cursor: pointer; } .payment-option.selected { border-color: #1650ff; } .show { display: block; } .submit { width: 100%; height: 56px; border-radius: 12px; background: #1650ff; color: #fff; border: none; text-decoration: none; cursor: pointer; font-size: 16px; display: block; margin-top: 32px; } .radio-group { display: flex; flex-direction: column; } .radio-group label { display: flex; align-items: center; margin-bottom: 8px; padding: 8px 16px; border: 1px solid #ebebeb; background: #fff; border-radius: 12px; color: #2a3a52; font-size: 16px; font-weight: 400; line-height: 24px; } .radio-group label.show { display: flex; } .radio-input { display: none; } .radio-button { width: 14px; height: 14px; border: 1px solid #abb9cc; margin-right: 8px; border-radius: 50%; } .radio-input:checked + .radio-button { border: 4px solid #1650ff; width: 8px; height: 8px; } .payment-icon { vertical-align: middle; display: flex; width: 32px; height: 32px; margin: 0 12px; padding: 4px 4.001px 3.996px 3.999px; justify-content: center; align-items: center; border-radius: 8px; border: 0.5px solid #f5f5f5; background: #fcfcfc; } .disabled { cursor: not-allowed; opacity: 0.5; pointer-events: none; } .hidden { display: none; } #result-container { display: flex; flex-direction: column; margin-top: 14px; align-items: flex-start; border-radius: 12px; border: 1px solid rgba(0, 0, 0, 0); padding: 12px 16px; color: #2a3a52; font-size: 13px; font-weight: 500; line-height: 20px; } .result-title { display: flex; align-items: center; } .result-title img { width: 20px; margin-right: 12px; } #content { color: #7c8ca3; text-align: center; font-size: 12px; font-weight: 400; line-height: 18px; margin-top: 8px; padding-left: 32px; } .mockup { display: none; z-index: 1000; width: 100vw; height: 100vh; position: fixed; top: 0px; left: 0px; background: rgba(0, 0, 0, 0.6); } .container-desktop { display: none; width: 370px; height: 248px; position: fixed; top: 50%; left: 50%; z-index: 1001; border-radius: 12px; overflow: hidden; transform-origin: 50% 50%; transform: translate(-50%, -50%); box-shadow: 0px 0px 8px 0px rgba(0, 0, 0, 0.1); padding: 40px 0px 24px 0px; background-color: #fff; } @keyframes container-zoom-in { 0% { transform: translate(-50%, -50%) scale(0.4); opacity: 0; } 80% { opacity: 1; } 100% { opacity: 1; transform: translate(-50%, -50%) scale(1); } } .desktop-animation { animation: container-zoom-in 0.3s ease-in-out; animation-fill-mode: forwards; } .container-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } .container-content img { width: 64px; height: 64px; } .container-title { color: var(--Content-Primary, #2a3a52); text-align: center; font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .container-subTitle { color: #7c8ca3; text-align: center; font-size: 14px; font-weight: 400; line-height: 20px; margin-top: 24px; } .container-btn { display: flex; width: 338px; height: 48px; padding: 0px 24px; justify-content: center; align-items: center; border-radius: var(---Button, 12px); background: var(--Action-Normal, #1650ff); border: none; cursor: pointer; color: var(--Content-Quaternary, #fff); font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .footer { display: flex; justify-content: center; margin-top: 20px; color: #bcbcbc; font-size: 16px; font-weight: 500; line-height: 24px; } .gotoTest { color: #1650ff; margin: 0 4px; text-decoration: none; } `] }, `Web-HTML-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/App.jsx', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `javascript`, filename: 'client/src/App.jsx', downloadOnly: false, steps: [`build-the-easysafepay-page`, `initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`import { useEffect, useRef, useState } from 'react'; import { AMSEasyPay } from '@alipay/ams-checkout'; import './App.css'; function App() { const amount = { currency: 'HKD', value: '980.80', mul: 1 }; const [selectedPaymentOptionId, setSelectedPaymentOptionId] = useState('ALIPAY_HK'); const [isLoading, setBtnLoading] = useState(false); const [paymentResult, setPaymentResult] = useState({ title: '', message: '', icon: '', bgColor: '', borderColor: '', }); const [alert, setAlert] = useState({ title: '', subTitle: '', iconType: '', }); const easyPayAppRef = useRef(null); const paymentOptions = [ { label: 'AliPay HK', value: 'ALIPAY_HK', icon: 'https://gw.alipay.com/icon/medium/default/ALIPAY_HK.svg', }, ]; const currencyMap = { ALIPAY_HK: { currency: 'HKD', value: '980.80', }, }; const renderAlert = () => { if (!alert.title) return; const icons = { warning: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ', error: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ', success: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ', }; return ( <>

{alert.title}

{alert.subTitle}

); }; const renderPaymentResult = () => { if (!paymentResult) return; const { title, message, icon, bgColor, borderColor } = paymentResult; return (

{title}

{message}

); }; const handlePaymentStatus = (status) => { setTimeout(() => { window.location.href = './index.html'; }, 8000); switch (status) { case 'SUCCESS': setPaymentResult({ title: 'Payment Successful', message: 'Thank you for your payment! We will ship out your order as soon as possible.', icon: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*ZLggSbkLKoMAAAAAAAAAAAAAAQAAAQ', bgColor: '#e5f7f1', borderColor: '#b7e9d9', }); break; case 'FAIL': setPaymentResult({ title: 'Payment Failed', message: 'Please return to the merchant order page and resubmit your payment.', icon: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ', bgColor: 'rgba(255, 91, 77, 0.10)', borderColor: 'rgba(255, 91, 77, 0.20)', }); break; case 'ERROR': setPaymentResult({ title: 'Error', message: 'An error occurred while checking the payment status. Please try again or contact support.', icon: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*QzBHQ40jKZAAAAAAAAAAAAAAAQAAAQ', bgColor: 'rgba(255, 91, 77, 0.10)', borderColor: 'rgba(255, 91, 77, 0.20)', }); break; default: setPaymentResult({ title: 'Payment Processing', message: 'Please return to the merchant order page and resubmit your payment.', icon: 'https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*7ShHRKjYcjoAAAAAAAAAAAAAAQAAAQ', bgColor: 'rgba(255, 159, 26, 0.10)', borderColor: 'rgba(255, 159, 26, 0.20) ', }); } }; // Step 6: Create Polling mechanism to retrieve the payment result. const pollPaymentResult = async () => { const paymentRequestId = new URLSearchParams( window.location.search ).get('paymentRequestId'); if (!paymentRequestId) return; const poll = async () => { let status = 'PROCESSING'; let retries = 0; const maxRetries = 5; while (retries < maxRetries) { try { const statusResult = await inquiryPayment(paymentRequestId); status = statusResult ?? 'ERROR'; } catch (error) { status = 'ERROR'; } retries += 1; if (status === 'SUCCESS' || retries === maxRetries) { return handlePaymentStatus(status); } await new Promise((resolve) => setTimeout(resolve, 2000)); } }; poll(); }; // Step 5: Call the inquiryPayment API to get the payment status.`] }, `Web-React-SDK-other1`), _jsx(AntomChunk, { language: `javascript`, steps: [`display-the-payment-result`], chunks: [` const inquiryPayment = async (paymentRequestId) => { // Define the URL for your backend endpoint. const baseUrl = 'http://localhost:8080/payment/inquiryPayment'; const config = { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ paymentRequestId }), }; const response = await fetch(baseUrl, config); if (!response.ok) throw new Error('Network response was not ok'); const res = await response.json(); return res.status === 'success' ? res.data.paymentStatus : 'ERROR'; }; `] }, `Web-React-SDK-code5`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` // Step 4: Get payment session data from the endpoint.`] }, `Web-React-SDK-other2`), _jsx(AntomChunk, { language: `javascript`, steps: [`get-a-payment-session`], chunks: [` const handleSubmit = async () => { const getPaymentSessionData = async () => { setBtnLoading(true); if (!selectedPaymentOptionId) { setAlert({ title: 'Warning', subTitle: 'Please select a payment method!', iconType: 'warning', }); setBtnLoading(false); return null; } try { // Define the URL for your backend endpoint. const url = 'http://localhost:8080/payment/createSession'; const body = JSON.stringify({ // In practice, amount should be calculated on your server side. amountValue: amount.value, currency: amount.currency, paymentMethodType: selectedPaymentOptionId, // Replace with the specific userId. userId: 'antom-easysafepay', }); const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body, }); if (!response.ok) { throw new Error('HTTP error! Status: ' + response.status); } const res = await response.json(); if (res.status === 'success') return res; throw new Error(res.message || 'Invalid response format'); } catch (error) { setAlert({ title: 'Error', subTitle: error.message || 'Failed to fetch payment session data', iconType: 'error', }); return null; } finally { setBtnLoading(false); } }; `] }, `Web-React-SDK-code3`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` try { const paymentResponse = await getPaymentSessionData(); if ( paymentResponse && paymentResponse?.data?.result?.resultStatus === 'S' && paymentResponse?.data?.paymentSessionData !== null ) { await createPopupEasyPay( paymentResponse.data.paymentSessionData ); } else if (paymentResponse?.paymentRequestId) { // exception handling console.error(paymentResponse); } } catch (error) { setAlert({ title: 'Error', subTitle: error.message || 'Failed to process payment', iconType: 'error', }); } }; // Step 3: Create the EasyPay payment rendering component.`] }, `Web-React-SDK-other3`), _jsx(AntomChunk, { language: `javascript`, steps: [`invoke-the-sdk`], chunks: [` const createPopupEasyPay = async (paymentSessionData) => { try { if (!easyPayAppRef.current) return; await easyPayAppRef.current.createComponent({ sessionData: paymentSessionData, notRedirectAfterComplete: false, }); } catch (error) { setAlert({ title: error.code, subTitle: error.message || 'Invalid response format', iconType: 'error', }); } }; `] }, `Web-React-SDK-code4`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` // Step 2: Create onEventCallback handler. const onEventCallback = ({ code }) => { switch (code) { case 'SDK_PAYMENT_CANCEL': console.log( 'The buyer canceled the payment (the buyer exited the payment page without submitting the order). You can re-invoke the SDK using paymentSessionData within its validity period; If it has expired, you need to initiate a new createPaymentSession (EasySafePay) request.' ); break; case 'SDK_CALL_URL_SUCCESS': console.log('Successfully opened the payment method app or redirected to the merchant page.'); break; case 'SDK_LAUNCH_PAYMENT_APP_ERROR': console.log('Failed to redirect to the checkout page of the payment method, or failed to redirect to the merchant page. Check whether the paymentRedirectUrl parameter is correctly passed when calling the createPaymentSession (EasySafePay) request. Web/WAP scenarios rarely experience redirection exceptions. However, in the event of any exceptions, it is recommended to verify the redirection link.'); break; case 'SDK_PAYMENT_SUCCESSFUL': console.log('The wallet has successfully processed the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; case 'SDK_PAYMENT_FAIL': console.log('The wallet failed to process the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result. Suggest redirecting users to the payment result page.'); break; default: console.log(code); } }; useEffect(() => {`] }, `Web-React-SDK-other4`), _jsx(AntomChunk, { language: `javascript`, steps: [`initialize-instantiate-the-sdk`], chunks: [` // Optional Step: Preload SDK resources. AMSEasyPay.preload(); // Step 1: Create an SDK instance. easyPayAppRef.current = new AMSEasyPay({ environment: 'sandbox', locale: 'en_US', onEventCallback, }); `] }, `Web-React-SDK-code2`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` // Step 7: Poll for the payment status. pollPaymentResult(); }, []); `] }, `Web-React-SDK-other5`), _jsx(AntomChunk, { language: `javascript`, steps: [`build-the-easysafepay-page`], chunks: [` return ( <>

Easysafepay Demo

Choose your payment method

{paymentOptions.map( ({ label, value, icon }) => { return ( setSelectedPaymentOptionId( event.target.value ) } checked={ selectedPaymentOptionId === value } />

{label} ); } )}

{renderPaymentResult()}

{renderAlert()}

This page is used only for sandbox testing, for more testing information, please refer Testing resources

); } `] }, `Web-React-SDK-code1`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`export default App; `] }, `Web-React-SDK-other6`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/App.css', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/src/App.css', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`body { margin: 0; padding: 0; font-family: 'PingFang SC'; display: flex; flex-direction: column; height: 100vh; margin: 0 auto; } .antom-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } header { width: 100%; height: 72px; background: #fdfdfd; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .header-content { margin: 0 auto; width: 70%; height: 100%; display: flex; align-items: center; justify-content: flex-start; } .header-content-img { width: 120px; } .header-content .subtitle { margin-left: 28px; color: #bcbcbc; font-size: 16px; font-style: normal; font-weight: 500; line-height: 24px; } .content { display: flex; flex-direction: column; position: relative; overflow: hidden; margin-top: 82px; height: 800px; flex-shrink: 0; border-radius: 40px; background: #fff; box-shadow: 0px 0px 10px 0px rgba(0, 0, 0, 0.1); } .headerContent { display: flex; align-items: center; justify-content: flex-start; } .headerContent .logo { margin: 0 10px; } .headerContent .testDemo { width: 62px; height: 16px; display: flex; align-items: center; justify-content: center; border-radius: 4px; background: rgba(0, 0, 0, 0.1); color: rgba(0, 0, 0, 0.4); font-size: 8px; font-weight: 400; } .checkout-container { margin: 0 auto; width: 100%; display: flex; flex-direction: column; flex-grow: 1; width: 660px; height: 100%; padding: 162px 64px 76px 56px; box-sizing: border-box; } p { display: inline-flex; align-items: center; gap: 10px; color: #2a3a52; } .payment-option { border: 2px solid #000; padding: 10px; margin-bottom: 20px; display: none; cursor: pointer; } .payment-option.selected { border-color: #1650ff; } .show { display: block; } .submit { width: 100%; height: 56px; border-radius: 12px; background: #1650ff; color: #fff; border: none; text-decoration: none; cursor: pointer; font-size: 16px; display: block; margin-top: 32px; } .radio-group { display: flex; flex-direction: column; } .radio-group label { display: flex; align-items: center; margin-bottom: 8px; padding: 8px 16px; border: 1px solid #ebebeb; background: #fff; border-radius: 12px; color: #2a3a52; font-size: 16px; font-weight: 400; line-height: 24px; } .radio-group label.show { display: flex; } .radio-input { display: none; } .radio-button { width: 14px; height: 14px; border: 1px solid #abb9cc; margin-right: 8px; border-radius: 50%; } .radio-input:checked + .radio-button { border: 4px solid #1650ff; width: 8px; height: 8px; } .payment-icon { vertical-align: middle; display: flex; width: 32px; height: 32px; margin: 0 12px; padding: 4px 4.001px 3.996px 3.999px; justify-content: center; align-items: center; border-radius: 8px; border: 0.5px solid #f5f5f5; background: #fcfcfc; } .disabled { cursor: not-allowed; opacity: 0.5; pointer-events: none; } /* Result */ .hidden { display: none; } #result-container { display: flex; flex-direction: column; margin-top: 14px; align-items: flex-start; border-radius: 12px; border: 1px solid rgba(0, 0, 0, 0); padding: 12px 16px; color: #2a3a52; font-size: 13px; font-weight: 500; line-height: 20px; } .result-title { display: flex; align-items: center; } .result-title img { width: 20px; margin-right: 12px; } #content { color: #7c8ca3; text-align: center; font-size: 12px; font-weight: 400; line-height: 18px; margin-top: 8px; padding-left: 32px; } /* The Modal (background) */ .mockup { /* display: none; */ z-index: 1000; width: 100vw; height: 100vh; position: fixed; top: 0px; left: 0px; background: rgba(0, 0, 0, 0.6); } /* Modal Content/Box */ .container-desktop { /* display: none; */ width: 370px; height: 248px; position: fixed; top: 50%; left: 50%; z-index: 1001; border-radius: 12px; overflow: hidden; transform-origin: 50% 50%; transform: translate(-50%, -50%); box-shadow: 0px 0px 8px 0px rgba(0, 0, 0, 0.1); padding: 40px 0px 24px 0px; background-color: #fff; } @keyframes container-zoom-in { 0% { transform: translate(-50%, -50%) scale(0.4); opacity: 0; } 80% { opacity: 1; } 100% { opacity: 1; transform: translate(-50%, -50%) scale(1); } } .desktop-animation { animation: container-zoom-in 0.3s ease-in-out; animation-fill-mode: forwards; } .container-content { display: flex; flex-direction: column; align-items: center; justify-content: center; } .container-content img { width: 64px; height: 64px; } .container-title { color: var(--Content-Primary, #2a3a52); text-align: center; font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .container-subTitle { color: #7c8ca3; text-align: center; font-size: 14px; font-weight: 400; line-height: 20px; margin-top: 24px; } .container-btn { display: flex; width: 338px; height: 48px; padding: 0px 24px; justify-content: center; align-items: center; border-radius: var(---Button, 12px); background: var(--Action-Normal, #1650ff); border: none; cursor: pointer; color: var(--Content-Quaternary, #fff); font-size: 16px; font-weight: 500; line-height: 24px; margin-top: 24px; } .footer { display: flex; justify-content: center; margin-top: 20px; color: #bcbcbc; font-size: 16px; font-weight: 500; line-height: 24px; } .gotoTest { color: #1650ff; margin: 0 4px; text-decoration: none; } `] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/main.jsx', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/src/main.jsx', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`import { StrictMode } from 'react'; import { createRoot } from 'react-dom/client'; import App from './App.jsx'; createRoot(document.getElementById('root')).render( ); `] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/index.html', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/index.html', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` Antom Demo Checkout

`] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/package.json', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/package.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`{ "name": "antom-sdk-merchant-react-client", "author": "rongzhao.lee", "version": "0.0.0", "type": "module", "scripts": { "dev": "vite", "build": "vite build", "preview": "vite preview", "format": "prettier --write .", "lint": "eslint ." }, "dependencies": { "@alipay/ams-checkout": "^1.18.0", "react": "^18.3.1", "react-dom": "^18.3.1", "react-router-dom": "^6.26.1" }, "devDependencies": { "@eslint/js": "^9.8.0", "@types/react": "^18.3.3", "@types/react-dom": "^18.3.0", "@vitejs/plugin-react": "^4.3.1", "eslint": "^9.8.0", "eslint-plugin-react": "^7.35.0", "eslint-plugin-react-hooks": "^5.1.0-rc.0", "eslint-plugin-react-refresh": "^0.4.9", "globals": "^15.9.0", "prettier": "^3.3.3", "vite": "^5.4.0" }, "repository": "https://code.alipay.com/antom-example/antom-online-payment-sample-web.git" } `] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/README.md', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`# Project Title antom-online-payments-demo-using-npm-sdk ## Prerequisites - **Node.js**: Ensure that you have Node.js installed on your machine. You can download it from [nodejs.org](https://nodejs.org/).`, '- **npm**: Node.js comes with npm (Node Package Manager). Ensure you have the latest version by running `npm install -g npm`.', ` ## Getting Started This demo project showcases how Antom payment works. For more detailed information, visit the [Antom Documentation](https://docs.antom.com/). Follow these steps to set up and run the project: ### 1. Install Dependencies Once inside the project directory, install the required dependencies using npm: `, '```bash', `npm install`, '```', ` ### 2. Start the Client `, '```bash', `npm run dev`, '```', ` `] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/react/vite.config.js', when: { platform: 'Web', client: 'React', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/vite.config.js', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`import { defineConfig } from 'vite'; import react from '@vitejs/plugin-react'; // https://vitejs.dev/config/ export default defineConfig({ plugins: [react()], server: { port: 5173, }, }); `] }, `Web-React-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/App.vue', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `javascript`, filename: 'client/src/App.vue', downloadOnly: false, steps: [`build-the-easysafepay-page`, `initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `javascript`, steps: [`build-the-easysafepay-page`], chunks: [` `] }, `Web-Vue-SDK-code1`), _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` `] }, `Web-Vue-SDK-other5`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/main.ts', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/src/main.ts', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`import { createApp } from 'vue'; import App from './App.vue'; const app = createApp(App); app.mount('#app'); `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/vite-env.d.ts', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/src/vite-env.d.ts', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`/// `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/tsconfig.node.json', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/tsconfig.node.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`{ "compilerOptions": { "target": "ES2022", "lib": ["ES2023"], "module": "ESNext", "skipLibCheck": true, /* Bundler mode */ "moduleResolution": "bundler", "allowImportingTsExtensions": true, "isolatedModules": true, "moduleDetection": "force", "noEmit": true, /* Linting */ "strict": true, "noUnusedLocals": true, "noUnusedParameters": true, "noFallthroughCasesInSwitch": true }, "include": ["vite.config.ts"] } `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/index.html', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/index.html', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [` Antom Demo Checkout

`] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/tsconfig.app.json', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/tsconfig.app.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`{ "compilerOptions": { "target": "ES2020", "useDefineForClassFields": true, "module": "ESNext", "lib": ["ES2020", "DOM", "DOM.Iterable"], "skipLibCheck": true, /* Bundler mode */ "moduleResolution": "bundler", "allowImportingTsExtensions": true, "isolatedModules": true, "moduleDetection": "force", "noEmit": true, "jsx": "preserve", /* Linting */ "strict": true, "noUnusedLocals": true, "noUnusedParameters": true, "noFallthroughCasesInSwitch": true }, "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"] } `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/README.md', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`# Project Title antom-online-payments-demo-using-npm-sdk ## Prerequisites - **Node.js**: Ensure that you have Node.js installed on your machine. You can download it from [nodejs.org](https://nodejs.org/).`, '- **npm**: Node.js comes with npm (Node Package Manager). Ensure you have the latest version by running `npm install -g npm`.', ` ## Getting Started This demo project showcases how Antom payment works. For more detailed information, visit the [Antom Documentation](https://docs.antom.com/). Follow these steps to set up and run the project: ### 1. Install Dependencies Once inside the project directory, install the required dependencies using npm: `, '```bash', `npm install`, '```', ` ### 2. Start the Client `, '```bash', `npm run dev`, '```', ` `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/package.json', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/package.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`{ "name": "antom-sdk-merchant-vue-client", "author": "rongzhao.lee", "version": "0.0.0", "type": "module", "scripts": { "dev": "vite", "build": "vue-tsc -b && vite build", "preview": "vite preview", "format": "prettier --write .", "lint": "eslint ." }, "dependencies": { "@alipay/ams-checkout": "^1.18.0", "vue": "^3.4.35", "vue-router": "^4.4.3" }, "devDependencies": { "@eslint/js": "^9.9.0", "@vitejs/plugin-vue": "^5.1.2", "prettier": "^3.3.3", "sass-embedded": "^1.77.8", "typescript": "^5.5.3", "vite": "^5.4.0", "vue-tsc": "^2.0.29" }, "repository": "https://code.alipay.com/antom-example/antom-online-payment-sample-web.git" } `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/tsconfig.json', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/tsconfig.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`{ "files": [], "references": [ { "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" } ] } `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/web/vue/vite.config.ts', when: { platform: 'Web', client: 'Vue', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `javascript`, filename: 'client/vite.config.ts', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `javascript`, steps: [``], chunks: [`import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; // https://vitejs.dev/config/ export default defineConfig({ plugins: [vue()], }); `] }, `Web-Vue-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/MainActivity.java', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `java`, filename: 'client/src/main/java/com/antom/easy_safe_pay_sdk_java/MainActivity.java', downloadOnly: false, steps: [`build-the-easysafepay-page`, `initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `listen-for-callback-addresses`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`package com.antom.easy_safe_pay_sdk_java; import android.annotation.SuppressLint; import android.app.Activity; import android.content.Intent; import android.graphics.drawable.Drawable; import android.net.Uri; import android.os.Bundle; import android.view.View; import android.widget.Button; import android.widget.RadioButton; import android.widget.TextView; import androidx.appcompat.app.AppCompatActivity; import androidx.core.content.ContextCompat; import com.alipay.ams.component.sdk.callback.OnCheckoutListener; import com.alipay.ams.component.sdk.model.AMSEventResult; import com.alipay.ams.component.sdk.payment.AMSEasyPay; import com.alipay.ams.component.sdk.payment.AMSEasyPayConfiguration; import com.antom.easy_safe_pay_sdk_java.Common.*; import org.json.JSONObject; import java.util.Locale; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; public class MainActivity extends AppCompatActivity { PaymentMethodView selectPayment; RadioButton paymentMethod1; Button tvPay; ExecutorService executorService = Executors.newSingleThreadExecutor(); `] }, `Android-Java-SDK-other1`), _jsx(AntomChunk, { language: `java`, steps: [`build-the-easysafepay-page`], chunks: [` @SuppressLint("SetTextI18n") @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); paymentMethod1 = findViewById(R.id.payment_method_1); ((TextView) findViewById(R.id.title)).setText("Easysafepay SDK"); tvPay = findViewById(R.id.tv_pay); createPaymentMethodView(paymentMethod1, new PaymentMethodView(R.drawable.alipay_hk, "Alipay HK", "ALIPAY_HK", "HKD", "980.80")); tvPay.setEnabled(selectPayment == null); tvPay.setOnClickListener(view -> { easySafePayment(); }); } private void createPaymentMethodView(RadioButton radioButton, PaymentMethodView paymentMethodView) { Drawable image = ContextCompat.getDrawable(this, paymentMethodView.getDrawableResId()); if (image == null) return; image.setBounds(0, 0, 120, 120); radioButton.setCompoundDrawables(image, null, null, null); radioButton.setText(paymentMethodView.getTitle()); radioButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { selectPayment = paymentMethodView; tvPay.setEnabled(true); tvPay.setText(String.format("Pay-%s-%s ", selectPayment.getCurrency(), selectPayment.getAmount())); } }); } `] }, `Android-Java-SDK-code1`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` String bodyeasyPayparams() { // You can use Gson or other Json format utils. return "{" + "\\"amountValue\\":\\"" + selectPayment.getAmount() + "\\"," + "\\"currency\\":\\"" + selectPayment.getCurrency() + "\\"," + "\\"userId\\":\\"" + "antom-easysafepay" + "\\"," + "\\"paymentMethodType\\":\\"" + selectPayment.getPaymentMethodCode() + "\\"" + "}"; } `] }, `Android-Java-SDK-other2`), _jsx(AntomChunk, { language: `java`, steps: [`get-a-payment-session`], chunks: [` private void easySafePayment() { LoadingIndicator.getInstance().showLoading(this); if (selectPayment == null) { AlertUtils.showAlertWithMessage(this, "No payment method selected!"); return; } // Before creating a payment session, it is highly recommended that you preload the SDK to improve the rendering speed of the checkout page, reducing the waiting time for buyers during the payment. AMSEasyPay.preload(getApplicationContext()); executorService.submit(() -> { HttpService.HttpResponse response = HttpService.instance.request(HttpService.Method.POST, "/payment/createSession", bodyeasyPayparams(), null); runOnUiThread(() -> { LoadingIndicator.getInstance().dismissLoading(); if (response.getErrorMessage() != null) { AlertUtils.showAlertWithMessage(MainActivity.this, response.getErrorMessage()); } else { if (response.isSuccess()) { String sessionData = response.getResponseBody().optJSONObject("data").optString("paymentSessionData"); if (!sessionData.isEmpty()) { createComponent(this, sessionData); } } else { AlertUtils.showAlertWithMessage(MainActivity.this, "No data response"); } } }); }); } `] }, `Android-Java-SDK-code3`), _jsx(AntomChunk, { language: `java`, steps: [`invoke-the-sdk`], chunks: [` private void createComponent(Activity activity, String sessionData) { AMSEasyPay checkout = new AMSEasyPay.Builder(activity, getConfiguration()).build(); checkout.createComponent(activity, sessionData); } `] }, `Android-Java-SDK-code4`), _jsx(AntomChunk, { language: `java`, steps: [`initialize-instantiate-the-sdk`], chunks: [` private AMSEasyPayConfiguration getConfiguration() { AMSEasyPayConfiguration configuration = new AMSEasyPayConfiguration(); configuration.setLocale(new Locale("en", "US")); configuration.setOption("sandbox", "true"); configuration.setOnCheckoutListener(new OnCheckoutListener() { @Override public void onEventCallback(String eventCode, AMSEventResult eventResult) { if (selectPayment != null && selectPayment.getPaymentMethodCode().equals("ALIPAY_CN")) { switch (eventCode) { case "SDK_PAYMENT_CANCEL": AlertUtils.showAlertWithMessage(MainActivity.this, "The buyer canceled the payment (the buyer exited the payment page without submitting the order). You can re-invoke the SDK using paymentSessionData within its validity period; If it has expired, you need to initiate a new createPaymentSession (EasySafePay) request."); break; case "SDK_PAYMENT_SUCCESSFUL": AlertUtils.showAlertWithMessage(MainActivity.this, "The Alipay wallet has successfully processed the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result."); break; case "SDK_PAYMENT_FAIL": AlertUtils.showAlertWithMessage(MainActivity.this, "The Alipay wallet failed to process the payment. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result."); break; case "SDK_PAYMENT_PROCESSING": AlertUtils.showAlertWithMessage(MainActivity.this, "The payment status of the Alipay wallet is unknown. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result."); break; case "SDK_PAYMENT_ERROR": AlertUtils.showAlertWithMessage(MainActivity.this, "The payment processing of the Alipay wallet is abnormal. Please obtain the final payment result from Antom server. You can use the inquiryPayment API or the notifyPayment API to confirm the result."); break; default: AlertUtils.showAlertWithMessage(MainActivity.this, "eventCode=" + eventCode + " message=" + eventResult.getMessage()); break; } } else { // The payment success result will not be returned by this callback function. A redirection to the payment success result page that you specified will take place instead. // When integrating with AlipayCN, you will receive the payment event codes returned by onEventCallback. switch (eventCode) { case "SDK_PAYMENT_CANCEL": AlertUtils.showAlertWithMessage(MainActivity.this, "The buyer canceled the payment (the buyer exited the payment page without submitting the order). You can re-invoke the SDK using paymentSessionData within its validity period; If it has expired, you need to initiate a new createPaymentSession (EasySafePay) request."); break; case "SDK_CALL_URL_SUCCESS": AlertUtils.showAlertWithMessage(MainActivity.this, "Successfully opened the payment method app or redirected to the merchant page."); break; case "SDK_CALL_URL_ERROR": AlertUtils.showAlertWithMessage(MainActivity.this, "Failed to redirect to merchant page, or failed to redirect to the 3D challenge page. Check whether the paymentRedirectUrl parameter is correctly passed when calling the createPaymentSession (EasySafePay) request. If frequent redirection exceptions occur, contact Antom Technical Support to troubleshoot redirection or cross-application calling issues."); break; case "SDK_CREATEPAYMENT_PARAMETER_ERROR": AlertUtils.showAlertWithMessage(MainActivity.this, "The parameters passed to the createComponent method are not correct. Check if the parameters are correct and re-initialize the component."); break; default: AlertUtils.showAlertWithMessage(MainActivity.this, "eventCode=" + eventCode + " message=" + eventResult.getMessage()); break; } } } }); return configuration; } `] }, `Android-Java-SDK-code2`), _jsx(AntomChunk, { language: `java`, steps: [`listen-for-callback-addresses`], chunks: [` @Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); Uri uri = intent.getData(); if (uri != null) { String paymentRequestId = uri.getQueryParameter("paymentRequestId"); onInquiryPaymentAction(paymentRequestId); } } `] }, `Android-Java-SDK-code5`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` String bodyInquiryPaymentParamsJson(String paymentRequestId) { // You can use Gson or other Json format utils. return "{" + "\\"paymentRequestId\\":\\"" + paymentRequestId + "\\"" + "}"; } `] }, `Android-Java-SDK-other3`), _jsx(AntomChunk, { language: `java`, steps: [`display-the-payment-result`], chunks: [` private void onInquiryPaymentAction(String paymentRequestId) { LoadingIndicator.getInstance().showLoading(this); executorService.submit(() -> { String resultSuccessMessage = ""; int maxCount = 5; int currentCount = 0; while (currentCount < maxCount) { try { HttpService.HttpResponse response = HttpService.instance.request(HttpService.Method.POST, "/payment/inquiryPayment", bodyInquiryPaymentParamsJson(paymentRequestId), null); if (response.isSuccess()) { InquiryPaymentResult paymentResult = new InquiryPaymentResult( response.getResponseBody().optJSONObject("data"), response.getResponseBody().optString("paymentRequestId"), response.getResponseBody().optString("authState"), response.getResponseBody().optString("status"), response.getResponseBody().optString("message")); JSONObject dataresult = paymentResult.getData().optJSONObject("result"); String resultCode = dataresult != null ? dataresult.optString("resultCode") : null; if ("SUCCESS".equals(resultCode)) { resultSuccessMessage = "Payment Success"; break; } resultSuccessMessage = resultCode; currentCount++; } } catch (Exception e) { runOnUiThread(() -> { LoadingIndicator.getInstance().dismissLoading(); AlertUtils.showAlertWithMessage(MainActivity.this, "Payment Failed"); }); break; } } String finalResultSuccessMessage = resultSuccessMessage; runOnUiThread(() -> { LoadingIndicator.getInstance().dismissLoading(); AlertUtils.showAlertWithMessage(MainActivity.this, finalResultSuccessMessage); }); }); }`] }, `Android-Java-SDK-code6`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`} `] }, `Android-Java-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/Common.java', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `java`, filename: 'client/src/main/java/com/antom/easy_safe_pay_sdk_java/Common.java', downloadOnly: false, steps: [`build-the-easysafepay-page`, `initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`, `listen-for-callback-addresses`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`package com.antom.easy_safe_pay_sdk_java; import android.app.Activity; import android.app.Dialog; import android.content.Context; import android.content.DialogInterface; import android.util.Log; import android.view.Window; import android.view.WindowManager; import android.widget.ProgressBar; import androidx.annotation.DrawableRes; import androidx.appcompat.app.AlertDialog; import org.json.JSONObject; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.util.Map; public class Common { static public class AlertUtils { public static void showAlertWithMessage(Activity context, String message) { if (context == null || context.isFinishing() || (context.isDestroyed())) { return; } new AlertDialog.Builder(context) .setMessage(message)`] }, `Android-Java-SDK-other1`), _jsx(AntomChunk, { language: `java`, steps: [`build-the-easysafepay-page`], chunks: [` .setCancelable(true) .setPositiveButton("OK", new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int id) { dialog.dismiss(); } }) .show(); } } public static class HttpService { public static final String TAG = "HttpInfo"; public static final HttpService instance = new HttpService(); private static final String HOST_URL = "http://10.0.2.2:8080"; /** * Synchronous call running in a thread */ public HttpResponse request(Method method, String url, String body, Map requestParam) { String fullUrl = buildUrl(url, requestParam); HttpURLConnection connection = null; try { // Create the connection Log.d(TAG, "Request URL: " + fullUrl); Log.d(TAG, "Request Method: " + method); if (body != null) { Log.d(TAG, "Request Body: " + body); } URL urlObj = new URL(fullUrl); connection = (HttpURLConnection) urlObj.openConnection();`] }, `Android-Java-SDK-code1`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` connection.setRequestMethod(method.name()); connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8"); connection.setDoOutput(true); // To send request body // If POST method and body is provided if (method == Method.POST && body != null) { try (OutputStream os = connection.getOutputStream()) { byte[] input = body.getBytes(StandardCharsets.UTF_8); os.write(input, 0, input.length); }`] }, `Android-Java-SDK-other2`), _jsx(AntomChunk, { language: `java`, steps: [`get-a-payment-session`], chunks: [` } // Get the response int responseCode = connection.getResponseCode(); String responseMessage = connection.getResponseMessage(); StringBuilder responseBody = new StringBuilder(); try (BufferedReader in = new BufferedReader(new InputStreamReader( responseCode >= 200 && responseCode < 300 ? connection.getInputStream() : connection.getErrorStream(), StandardCharsets.UTF_8))) { String line; while ((line = in.readLine()) != null) { responseBody.append(line); } } Log.d(TAG, "Response Code: " + responseCode); Log.d(TAG, "Response Message: " + responseMessage); Log.d(TAG, "Response Body: " + responseBody); if (responseCode == HttpURLConnection.HTTP_OK) { JSONObject jsonObject = new JSONObject(responseBody.toString()); return new HttpResponse(jsonObject); } else { return new HttpResponse(responseMessage.isEmpty() ? "Failed" : responseMessage); } } catch (Exception e) { e.printStackTrace();`] }, `Android-Java-SDK-code3`), _jsx(AntomChunk, { language: `java`, steps: [`invoke-the-sdk`], chunks: [` return new HttpResponse(e.getMessage() != null ? e.getMessage() : "Unknown exception"); } finally { if (connection != null) { connection.disconnect(); }`] }, `Android-Java-SDK-code4`), _jsx(AntomChunk, { language: `java`, steps: [`initialize-instantiate-the-sdk`], chunks: [` } } private String buildUrl(String url, Map params) { StringBuilder urlBuilder = new StringBuilder(HOST_URL).append(url); if (params != null && !params.isEmpty()) { urlBuilder.append("?"); for (Map.Entry entry : params.entrySet()) { try { urlBuilder.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8.toString())) .append("=") .append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8.toString())) .append("&"); } catch (IOException e) { e.printStackTrace(); } } urlBuilder.setLength(urlBuilder.length() - 1); // Remove the trailing "&" } return urlBuilder.toString(); } public enum Method { POST, GET } public static class HttpResponse { private final JSONObject responseBody; private final String errorMessage; public HttpResponse(JSONObject responseBody) { this.responseBody = responseBody; this.errorMessage = null; // 成功响应时没有错误信息 } public HttpResponse(String errorMessage) { this.responseBody = null; // 失败响应时没有响应体 this.errorMessage = errorMessage; } public boolean isSuccess() { return responseBody != null; } public JSONObject getResponseBody() { return responseBody; } public String getErrorMessage() { return errorMessage; } } } `] }, `Android-Java-SDK-code2`), _jsx(AntomChunk, { language: `java`, steps: [`listen-for-callback-addresses`], chunks: [` public static class InquiryPaymentResult { private final JSONObject data; private final String paymentRequestId; private final String authState; private final String status; private final String message; public InquiryPaymentResult(JSONObject data, String paymentRequestId, String authState, String status, String message) { this.data = data; this.paymentRequestId = paymentRequestId;`] }, `Android-Java-SDK-code5`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` this.authState = authState; this.status = status; this.message = message; } public JSONObject getData() { return data;`] }, `Android-Java-SDK-other3`), _jsx(AntomChunk, { language: `java`, steps: [`display-the-payment-result`], chunks: [` } public String getPaymentRequestId() { return paymentRequestId; } public String getAuthState() { return authState; } public String getMessage() { return message; } public String getStatus() { return status; } } public static class LoadingIndicator { private static LoadingIndicator instance; private Dialog loadingDialog; private LoadingIndicator() { } public static LoadingIndicator getInstance() { if (instance == null) { instance = new LoadingIndicator(); } return instance; } public void showLoading(Context context) { if (loadingDialog == null) { loadingDialog = new Dialog(context); loadingDialog.setTitle("Loading..."); loadingDialog.requestWindowFeature(Window.FEATURE_NO_TITLE); loadingDialog.setContentView(new ProgressBar(context)); loadingDialog.setCancelable(false); `] }, `Android-Java-SDK-code6`), _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` Window window = loadingDialog.getWindow(); if (window != null) { window.setLayout(WindowManager.LayoutParams.WRAP_CONTENT, WindowManager.LayoutParams.WRAP_CONTENT); window.setBackgroundDrawableResource(android.R.color.transparent); // 可选，设置背景透明 } } loadingDialog.show(); } public void dismissLoading() { if (loadingDialog != null && loadingDialog.isShowing()) { loadingDialog.dismiss(); } } } public static class PaymentMethodView { @DrawableRes private final int drawableResId; private final String title; private final String paymentMethodCode; private final String currency; private final String amount; public PaymentMethodView( @DrawableRes int drawableResId, String title, String paymentMethodCode, String currency, String amount ) { this.drawableResId = drawableResId; this.title = title; this.paymentMethodCode = paymentMethodCode; this.currency = currency; this.amount = amount; } public int getDrawableResId() { return drawableResId; } public String getTitle() { return title; } public String getAmount() { return amount; } public String getCurrency() { return currency; } public String getPaymentMethodCode() { return paymentMethodCode; } } } `] }, `Android-Java-SDK-other4`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/AndroidManifest.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/AndroidManifest.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`

`] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/pay_btn_bg.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/drawable/pay_btn_bg.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/radiobtn_bg.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/drawable/radiobtn_bg.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/alipay_hk.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/drawable/alipay_hk.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/input_bg.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/drawable/input_bg.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/ic_launcher_background.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/drawable/ic_launcher_background.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `Android-Java-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/android/java/activity_main.xml', when: { platform: 'Android', client: 'Java', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/src/main/res/layout/activity_main.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/easypay_objc-Bridging-Header.h', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/easypay_objc-Bridging-Header.h', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`// // Use this file to import your target's public headers that you would like to expose to Swift. // `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/AppDelegate.h', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/AppDelegate.h', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` #import @interface AppDelegate : UIResponder @property(nonatomic,strong) UIWindow *window; @end `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/File.swift', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/File.swift', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`// // File.swift // // Created by ant on 2024/10/10. // import Foundation `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/Common.h', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/Common.h', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`// // Common.h // // Created by ant on 2024/11/12. // #import #import "UIKit/UIKit.h" NS_ASSUME_NONNULL_BEGIN @interface AlterUtils : NSObject + (void)showAlertWithMessage:(NSString *)message; @end @interface InquiryPaymentResult : NSObject @property (nonatomic, strong, readonly) NSDictionary *data; @property (nonatomic, copy, readonly) NSString *paymentRequestId; @property (nonatomic, copy, readonly) NSString *authState; @property (nonatomic, copy, readonly) NSString *status; @property (nonatomic, copy, readonly) NSString *message; - (instancetype)initWithData:(NSDictionary *)data paymentRequestId:(NSString *)paymentRequestId authState:(NSString *)authState status:(NSString *)status message:(NSString *)message; // 解析方法 + (instancetype)parseFromJSON:(NSDictionary *)json; @end @interface HttpResponse : NSObject @property (nonatomic, strong) NSDictionary *responseBody; @property (nonatomic, strong) NSString *errorMessage; + (instancetype)successWithResponseBody:(NSDictionary *)responseBody; + (instancetype)failureWithErrorMessage:(NSString *)errorMessage; @end typedef NS_ENUM(NSInteger, HttpMethod) { HttpMethodGET, HttpMethodPOST }; @interface HttpService : NSObject - (void)requestWithMethod:(HttpMethod)method urlpath:(NSString *)url body:(NSDictionary *)body requestParam:(NSDictionary *)params completion:(void (^)(HttpResponse *response))completion; + (instancetype)sharedInstance; @end @interface LoadingIndicator : NSObject + (instancetype)sharedInstance; - (void)showLoadingInView:(UIView *)view; - (void)dismissLoading; @end @interface PaymentMethodView : NSObject @property (nonatomic, copy) NSString *icon; @property (nonatomic, copy) NSString *title; @property (nonatomic, copy) NSString *paymentMethodCode; @property (nonatomic, copy) NSString *currency; @property (nonatomic, copy) NSString *amount; - (instancetype)initWithIcon:(NSString *)icon title:(NSString *)title paymentMethodCode:(NSString *)paymentMethodCode currency:(NSString *)currency amount:(NSString*)amount; -(NSString*)formatAmount; @end @class PaymentMethodView; @interface PaymentMethodViewCell : UITableViewCell @property (nonatomic, strong) PaymentMethodView *paymentMethod; @property (weak, nonatomic) IBOutlet UIButton *radioButton; @property (weak, nonatomic) IBOutlet UILabel *title; @property (weak, nonatomic) IBOutlet UIImageView *iconImage; - (void)configureWithPaymentMethod:(PaymentMethodView *)paymentMethod selected:(BOOL)selected; @end @interface ImageBase64Converter : NSObject + (NSString *)imageToBase64:(UIImage *)image; + (UIImage *)base64ToImage:(NSString *)base64String; @end NS_ASSUME_NONNULL_END `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/PaymentMethodViewCell.xib', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/PaymentMethodViewCell.xib', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/Podfile', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/Podfile', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`# Uncomment the next line to define a global platform for your project # https://docs.antom.com/ac/sdks/ios "pod mode requires account secret configuration" source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git' source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom' platform :ios, '11.0' target 'easypay_objc' do use_frameworks! pod 'AMSComponent' pod 'AMSSecurity' end `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/Info.plist', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/Info.plist', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [` CFBundleURLTypes CFBundleURLSchemes easysafepay NSAppTransportSecurity NSAllowsArbitraryLoads `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/objective-c/ViewController.h', when: { platform: 'iOS', client: 'Objective-C', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `java`, filename: 'client/ViewController.h', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `java`, steps: [``], chunks: [`// // ViewController.h // easypay_objc // // Created by ant on 2024/10/10. // #import @interface ViewController : UIViewController @end `] }, `iOS-Objective-C-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/ViewController.swift', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `swift`, filename: 'client/ViewController.swift', downloadOnly: false, steps: [`build-the-easysafepay-page`, `initialize-instantiate-the-sdk`, `get-a-payment-session`, `invoke-the-sdk`], children: [_jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` import UIKit import AMSComponent`] }, `iOS-Swift-SDK-other1`), _jsx(AntomChunk, { language: `swift`, steps: [`build-the-easysafepay-page`], chunks: [`class ViewController: UIViewController ,UITableViewDelegate,UITableViewDataSource,AMSPaymentProtocol{ @IBOutlet weak var titleLabel: UILabel! @IBOutlet weak var tipLabel: UILabel! @IBOutlet weak var btnCheckout: UIButton! lazy var tableView: UITableView = { let tableView = UITableView(frame: CGRect(x: 0, y: self.tipLabel.frame.maxY + 20, width: UIScreen.main.bounds.width, height: 300)) tableView.register(UINib(nibName: "SwiftPaymentMethodViewCell", bundle: nil), forCellReuseIdentifier: "SwiftPaymentMethodViewCell") tableView.delegate = self tableView.dataSource = self tableView.separatorStyle = .none return tableView }() lazy var paymentMethods:[SwiftPaymentMethodView] = { var methods:[SwiftPaymentMethodView] = []; methods = [ SwiftPaymentMethodView(icon: "iVBORw0KGgoAAAANSUhEUgAAAHgAAAA1CAYAAACKoi9gAAAAAXNSR0IArs4c6QAABDRJREFUeF7tmV1OGzEQx8ccoqg3yAOgqISPN5KbwElKTlJuQnjjI1RR4SE3qOgdGrfj3XHGjr0LWa+A0USqihbH65mf//8ZGwP6EZ0BIzo6DQ4UsPBNoIAVsPAMCA9PFayAhWdAeHiqYAUsPAPCw1MFK2DhGRAenipYAQvPgPDwVMEKWHgGhIenClbA75yBH7/HcPF19s6r+LSv71XBp6Ph+Ha+aIWD4yiDwfirP9cAdgxgZnD+ZfJps/yOC+8N8Onx8NJa+A4As7uHRRYOG+fScPewqNaEyjU71z43djVRJb99p/QG+ORoaGk5xsIkp+QsYAf55RKMOQNrb+Bi9/Lt4ek3egEcQ2tScSNg5dM5A70A5uptU3ET4ONve1619z+f/c+jvcEYdqCq2ytwNd4aVw7AGLjB/+e/loHi+XeshbPc2NHBAEuL/308D8VD44yF6fx5ue4zXN+AC/o7DUqKdyP2PPWssHMVB0zAjIFpXYMpJ8lanAM8Gu2NzQp8DbY7MJnPn10iD/cH3v7RHf7/802a31AGphwOAsZNQBvAMah6BPfB9eL4epx/Lz3nUqrhuu8+Pi3DHF69VGuLewZqGC1MfblJPXPQ63UV6DuKAyb1YmI2kpioxQUAA9Z4VBFPvINWP8/53AbMzDwxRHpPCj50AVwYrstBZ5NnE3D13t4vnEVGdr2h4q6A4yTH6n58WgYdvLPq+oObgo/nGyJ4ztygUb0477aAKxqVo3CVdwRUFDBXLwGOAcYddWfAkUoP9wdorx4iqY8sOmXn3qbZXDk3aFRvABgdbLWuzXTkS1k0nvPdeb8s3KIKTqkXX4CXGNasa2ncUZcGHIMhwLGysTnCRi2ow82bZYZuQPMk7ZkDzikvCTgafL5bTHjFJkqpl5Z9cjQMVOUvM3ADrC9E3HD63WubrLjOpgDzZ02WvjFX1ZitL1vqhi4LNwBsZu787u3BnDmV5gDjczzzx2M+gkXzWyvepdLa6mOHt01MUM7CSwImENy244YpV4Np7bHlO9uLOvSAwbY1GC9y+O1dgQ66iEVHCpylALvSUp0tPWQC2VXBaPm8keLAovrrlBirtA3wa45NxQA7Byh7/97ZonO1N3aWuBaTigsAdorCC4/6ssNtooQV+zLBjnDBpssdq7iKG9XbpYumq9hAxezMvKVVdwLM4XDbza0lVYsLAOYXHa5r3bhdqhcU1WfqcNelI3NuZt8L3CIZZxeLpgkLnoc7Ad5yU3X+Wputdn5BNEFr51z6hQXnU8CZZNKFCNl+qzUXhFJyKgWcyWbbjVhJCH3OpYBzCj4YVH+NWsEs+GtRnzR6mPtTAu4hD2KnVMBi0VaBKWAFLDwDwsNTBStg4RkQHp4qWAELz4Dw8FTBClh4BoSHpwpWwMIzIDw8VbACFp4B4eGpghWw8AwID08VLBzwP+ubmmOvZqGDAAAAAElFTkSuQmCC", title: "ALIPAY_HK", paymentMethodCode: "ALIPAY_HK", currency: "HKD", amount: "980.80"), ] return methods }() var selectedIndex: Int = -1 var selectMethod: SwiftPaymentMethodView? override func viewDidLoad() { super.viewDidLoad() initConfiguration() setUpView() } private func updateCheckoutDisplay(_ method: SwiftPaymentMethodView?) { btnCheckout.isEnabled = method != nil btnCheckout.backgroundColor = method == nil ? UIColor.gray : UIColor.blue let title = method == nil ? "Pay" : "Pay \\(String(describing: method?.formatAmount()))" btnCheckout.setTitle(title, for: .normal) } private func setUpView() { view.addSubview(self.tableView) btnCheckout.addTarget(self, action: #selector(easySafePayment), for: .touchUpInside) } // MARK: - UITableView DataSource Methods func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int { return self.paymentMethods.count } func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { let cell = tableView.dequeueReusableCell(withIdentifier: "SwiftPaymentMethodViewCell") as? SwiftPaymentMethodViewCell let paymentMethod = self.paymentMethods[indexPath.row] let isSelected = indexPath.row == selectedIndex cell?.configure(with: paymentMethod, selected: isSelected) return cell! } func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat { return 100 } func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) { if selectedIndex != indexPath.row { selectedIndex = indexPath.row tableView.reloadData() selectMethod = paymentMethods[selectedIndex] } } private func dicWithPaymethod(_ paymethod: SwiftPaymentMethodView) -> [String: Any] { return [ "amountValue": paymethod.amount, "currency": paymethod.currency, "paymentMethodType": paymethod.paymentMethodCode, "terminalType": "APP", "osType": "IOS", "userId":"antom-easysafepay" ] } `] }, `iOS-Swift-SDK-code1`), _jsx(AntomChunk, { language: `swift`, steps: [`initialize-instantiate-the-sdk`], chunks: [` func initConfiguration(){ let configuration = AMSAutoDebitConfiguration() configuration.options = ["sandbox": "true","showLoading":"true"] AMSCashierPayment.shared().initConfiguration(configuration) AMSCashierPayment.shared().paymentDelegate = self } `] }, `iOS-Swift-SDK-code2`), _jsx(AntomChunk, { language: `swift`, steps: [`get-a-payment-session`], chunks: [` @objc func easySafePayment() { guard let method = selectMethod else { AlterUtils.showAlertWithMessage( "Please choose your method") return } LoadingIndicator.sharedInstance.showLoading(in:self.view) HttpService.sharedInstance.request(method: HttpMethod.POST, urlPath: "/payment/createSession", body: dicWithPaymethod(method), requestParam: nil) {[weak self] response in`, ' guard let `self` = self else {return}', ` DispatchQueue.main.async { LoadingIndicator.sharedInstance.dismissLoading() if let errorMessage = response.errorMessage { print("Antom --- Error: \\(errorMessage)") AlterUtils.showAlertWithMessage( errorMessage) } else { print("Antom --- Response: \\(response.responseBody ?? [:])") if let data = response.responseBody?["data"] as? [String : Any], let sessionData = data["paymentSessionData"] as? String{ self.createAMSCheckout(sessionData: sessionData) } } } } } `] }, `iOS-Swift-SDK-code3`), _jsx(AntomChunk, { language: `swift`, steps: [`invoke-the-sdk`], chunks: [` func createAMSCheckout(sessionData: String) { AMSCashierPayment.shared().createComponent(sessionData) } `] }, `iOS-Swift-SDK-code4`), _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [`} `] }, `iOS-Swift-SDK-other2`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/AppDelegate.swift', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsxs(AntomFile, { language: `swift`, filename: 'client/AppDelegate.swift', downloadOnly: false, steps: [`listen-for-callback-addresses`, `display-the-payment-result`], children: [_jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` import UIKit @main class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow!`] }, `iOS-Swift-SDK-other1`), _jsx(AntomChunk, { language: `swift`, steps: [`listen-for-callback-addresses`], chunks: [` func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool { // custom scheme logic print("----\\(url)") if url.scheme == "easysafepay" { handlecashierUrl(url) } return true } `] }, `iOS-Swift-SDK-code1`), _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` func handlecashierUrl(_ url: URL) { var queryItemsDict = [String: String]() if let components = URLComponents(url: url, resolvingAgainstBaseURL: false) { for item in components.queryItems ?? [] { queryItemsDict[item.name] = item.value } } // get paymentRequestId if let paymentRequestId = queryItemsDict["paymentRequestId"]{ print("paymentRequestId: \\(paymentRequestId)") self.inquiryPaymentProcess(paymentRequestId) } } func inquiryPaymentDisplay(_ response: [String:Any]) { guard let inquiryPaymentResult = InquiryPaymentResult.parse(from: response) else { AlterUtils.showAlertWithMessage( "inquiryPaymentResult data is empty") return } if let result = inquiryPaymentResult.data?["result"] as? [String:Any] ,let resultCode = result["resultCode"] as? String { if resultCode == "SUCCESS" { AlterUtils.showAlertWithMessage( "Payment Success") } } } `] }, `iOS-Swift-SDK-other2`), _jsx(AntomChunk, { language: `swift`, steps: [`display-the-payment-result`], chunks: [` func inquiryPaymentProcess(_ paymentRequestId: String) { LoadingIndicator.sharedInstance.showLoading(in: self.window) HttpService.sharedInstance.request(method: HttpMethod.POST, urlPath: "/payment/inquiryPayment", body: ["paymentRequestId": paymentRequestId], requestParam: nil) {[weak self] response in`, ' guard let `self` = self else{ return}', ` DispatchQueue.main.async { LoadingIndicator.sharedInstance.dismissLoading() if let errorMessage = response.errorMessage { print("Antom --- Error: \\(errorMessage)") AlterUtils.showAlertWithMessage( errorMessage) } else { print("Antom --- Response: \\(response.responseBody ?? [:])") if let response = response.responseBody { self.inquiryPaymentDisplay(response) } else { AlterUtils.showAlertWithMessage( "inquiryPayment error") } } } } } `] }, `iOS-Swift-SDK-code2`), _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` } `] }, `iOS-Swift-SDK-other3`)] }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/Common.swift', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/Common.swift', downloadOnly: false, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [`// // Common.swift // subscription_payment_swift // // Created by ant on 2024/11/13. // import Foundation import UIKit class LoadingIndicator { static let sharedInstance = LoadingIndicator() private var activityIndicator: UIActivityIndicatorView! private var overlayView: UIView! func showLoading(in view: UIView) { if overlayView == nil { overlayView = UIView(frame: view.bounds) overlayView.backgroundColor = UIColor(white: 0, alpha: 0.3) activityIndicator = UIActivityIndicatorView(style: .white) activityIndicator.center = overlayView.center overlayView.addSubview(activityIndicator) } activityIndicator.startAnimating() view.addSubview(overlayView) overlayView.alpha = 0.0 UIView.animate(withDuration: 0.3) { self.overlayView.alpha = 1.0 } } func dismissLoading() { UIView.animate(withDuration: 0.3, animations: { self.overlayView.alpha = 0.0 }) { _ in self.activityIndicator.stopAnimating() self.overlayView.removeFromSuperview() self.overlayView = nil self.activityIndicator = nil } } } class AlterUtils: NSObject { static func showAlertWithMessage(_ message: String) { let topViewController = self.topViewController() if let topVC = topViewController { let alertController = UIAlertController(title: "Tip", message: message, preferredStyle: .alert) let okAction = UIAlertAction(title: "Close", style: .default, handler: nil) alertController.addAction(okAction) topVC.present(alertController, animated: true, completion: nil) } } static func topViewController() -> UIViewController? { if let rootViewController = UIApplication.shared.keyWindow?.rootViewController { return topViewControllerFrom(rootViewController) } return nil } static func topViewControllerFrom(_ vc: UIViewController?) -> UIViewController? { if let presentedViewController = vc?.presentedViewController { return topViewControllerFrom(presentedViewController) } else if let navController = vc as? UINavigationController { return topViewControllerFrom(navController.visibleViewController) } else if let tabBarController = vc as? UITabBarController { return topViewControllerFrom(tabBarController.selectedViewController) } else { return vc } } } // HttpMethod Enum enum HttpMethod: String { case GET case POST } // HttpResponse Class class HttpResponse { var responseBody: [String: Any]? var errorMessage: String? static func success(with responseBody: [String: Any]) -> HttpResponse { let response = HttpResponse() response.responseBody = responseBody return response } static func failure(with errorMessage: String) -> HttpResponse { let response = HttpResponse() response.errorMessage = errorMessage return response } } // HttpService Singleton Class class HttpService { static let sharedInstance = HttpService() private let HOST_URL = "http://127.0.0.1:8080" private init() {} func request(method: HttpMethod, urlPath: String, body: [String: Any]?, requestParam: [String: Any]?, completion: @escaping (HttpResponse) -> Void) { let fullUrl = buildUrl(urlPath: urlPath, params: requestParam) guard let url = URL(string: fullUrl) else { completion(HttpResponse.failure(with: "Invalid URL")) return } var request = URLRequest(url: url) request.setValue("application/json", forHTTPHeaderField: "Content-Type") if method == .POST { guard let body = body else { completion(HttpResponse.failure(with: "Body is nil for POST request")) return } do { let jsonData = try JSONSerialization.data(withJSONObject: body, options: []) request.httpMethod = method.rawValue request.httpBody = jsonData } catch { completion(HttpResponse.failure(with: error.localizedDescription)) return } } else { request.httpMethod = method.rawValue } print("Requesting URL: \\(fullUrl)") print("Request Method: \\(method.rawValue)") print("Request Headers: \\(String(describing: request.allHTTPHeaderFields))") print("Request Body: \\(String(describing: body))") let task = URLSession.shared.dataTask(with: request) { data, response, error in if let error = error { completion(HttpResponse.failure(with: error.localizedDescription)) return } guard let data = data else { completion(HttpResponse.failure(with: "No data received")) return } do { if let jsonResponse = try JSONSerialization.jsonObject(with: data, options: []) as? [String: Any], let status = jsonResponse["status"] as? String, status == "success" { completion(HttpResponse.success(with: jsonResponse)) } else { completion(HttpResponse.failure(with: "Error or status not successful")) } } catch { completion(HttpResponse.failure(with: error.localizedDescription)) } } task.resume() } private func buildUrl(urlPath: String, params: [String: Any]?) -> String { var urlString = "\\(HOST_URL)\\(urlPath)" if let params = params, !params.isEmpty { urlString.append("?") let queryItems = params.map { key, value in "\\(urlEncode(key))=\\(urlEncode("\\(value)"))" } urlString.append(queryItems.joined(separator: "&")) } return urlString } private func urlEncode(_ string: String) -> String { return string.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? string } } struct ImageBase64Converter { static func imageToBase64(image: UIImage) -> String? { guard let imageData = image.pngData() else { return nil } return imageData.base64EncodedString(options: .lineLength64Characters) } static func base64ToImage(base64String: String) -> UIImage? { guard let imageData = Data(base64Encoded: base64String) else { return nil } return UIImage(data: imageData) } } class SwiftPaymentMethodView: Codable { var icon: String var title: String var paymentMethodCode: String var currency: String var amount: String // Initializer init(icon: String, title: String, paymentMethodCode: String, currency: String, amount: String) { self.icon = icon self.title = title self.paymentMethodCode = paymentMethodCode self.currency = currency self.amount = amount } func formatAmount() -> String { return "\\(currency) \\(amount)" } } class SwiftPaymentMethodViewCell: UITableViewCell { @IBOutlet weak var radioButton: UIButton! @IBOutlet weak var titleLabel: UILabel! // Renamed for clarity @IBOutlet weak var iconImageView: UIImageView! override func awakeFromNib() { super.awakeFromNib() self.selectionStyle = .none if #available(iOS 13.0, *) { radioButton.setImage(UIImage.init(systemName: "circle"), for: .normal) radioButton.setImage(UIImage(systemName: "checkmark.circle"), for: .selected) } else { //TODO: custom image } } func configure(with paymentMethod: SwiftPaymentMethodView, selected: Bool) { self.paymentMethod = paymentMethod // Set the radio button state radioButton.isSelected = selected self.iconImageView.image = ImageBase64Converter.base64ToImage(base64String: paymentMethod.icon) self.titleLabel.text = paymentMethod.title } private var paymentMethod: SwiftPaymentMethodView! } class InquiryPaymentResult { var data: [String: Any]? var paymentRequestId: String? var authState: String? var status: String? var message: String? init(data: [String: Any], paymentRequestId: String, authState: String, status: String, message: String) { self.data = data self.paymentRequestId = paymentRequestId self.authState = authState self.status = status self.message = message } static func parse(from json: [String: Any]) -> InquiryPaymentResult? { guard let data = json["data"] as? [String: Any], let paymentRequestId = json["paymentRequestId"] as? String, let authState = json["authState"] as? String, let status = json["status"] as? String, let message = json["message"] as? String else { return nil } return InquiryPaymentResult(data: data, paymentRequestId: paymentRequestId, authState: authState, status: status, message: message) } } `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/Main.storyboard', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/Base.lproj/Main.storyboard', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/Podfile', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/Podfile', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [`# Uncomment the next line to define a global platform for your project # https://docs.antom.com/ac/sdks/ios "pod mode requires account secret configuration" source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git' source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom' platform :ios, '11.0' target 'easypay_swift' do # Comment the next line if you don't want to use dynamic frameworks use_frameworks! pod 'AMSComponent' pod 'AMSSecurity' end `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/easypay_swift_bridge.h', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/easypay_swift_bridge.h', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/Info.plist', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/Info.plist', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` CFBundleURLTypes CFBundleURLSchemes easysafepay NSAppTransportSecurity NSAllowsArbitraryLoads `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/easysafepay/files/ios/swift/SwiftPaymentMethodViewCell.xib', when: { platform: 'iOS', client: 'Swift', integration_type: 'SDK' }, children: _jsx(AntomFile, { language: `swift`, filename: 'client/SwiftPaymentMethodViewCell.xib', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `swift`, steps: [``], chunks: [` `] }, `iOS-Swift-SDK-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/web/html/README.md', when: { platform: 'Web', client: 'HTML', server: 'PHP' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Project Title antom-online-payments-demo-using-cdn-sdk ## Getting Started This demo project showcases how Antom payment works. For more detailed information, visit the [Antom Documentation](https://docs.antom.com/). Follow these steps to set up and run the project: `, '### 1. Install `http-server`', ` `, "To serve your site, you'll need to install `http-server`, a simple, zero-configuration command-line static HTTP server. You can install it globally using npm (Node Package Manager).", ` Open your terminal and run the following command: `, '``` bash', `npm install -g http-server`, '```', ` ### 2. Start the Client `, '``` bash', `http-server -p 5173 -a localhost`, '```', ` `] }, `Web-HTML-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/web/html/README.md', when: { platform: 'Web', client: 'HTML', server: 'Python' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Project Title antom-online-payments-demo-using-cdn-sdk ## Getting Started This demo project showcases how Antom payment works. For more detailed information, visit the [Antom Documentation](https://docs.antom.com/). Follow these steps to set up and run the project: `, '### 1. Install `http-server`', ` `, "To serve your site, you'll need to install `http-server`, a simple, zero-configuration command-line static HTTP server. You can install it globally using npm (Node Package Manager).", ` Open your terminal and run the following command: `, '``` bash', `npm install -g http-server`, '```', ` ### 2. Start the Client `, '``` bash', `http-server -p 5173 -a localhost`, '```', ` `] }, `Web-HTML-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/web/html/README.md', when: { platform: 'Web', client: 'HTML', server: 'Go' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Project Title antom-online-payments-demo-using-cdn-sdk ## Getting Started This demo project showcases how Antom payment works. For more detailed information, visit the [Antom Documentation](https://docs.antom.com/). Follow these steps to set up and run the project: `, '### 1. Install `http-server`', ` `, "To serve your site, you'll need to install `http-server`, a simple, zero-configuration command-line static HTTP server. You can install it globally using npm (Node Package Manager).", ` Open your terminal and run the following command: `, '``` bash', `npm install -g http-server`, '```', ` ### 2. Start the Client `, '``` bash', `http-server -p 5173 -a localhost`, '```', ` `] }, `Web-HTML-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/android/java/README.md', when: { platform: 'Android' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Directory demo description auto_debit //Signing withholding payment /api /sdk cashier_payment //Cashier payment /api /sdk easy_safe_pay //easypay subscription //subscription payment # Running conditions ## 1. Run the server code locally Select target and use cashier_payment_java api as an example. antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java ## 2. Change the service callback address`, '`alipayPayRequest.setPaymentRedirectUrl(', '"cashierapi://app/receivePayment?paymentRequestId=" + paymentRequestId);`', ` ## 3. Config merchant info antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java // public static final String CLIENT_ID = ""; // public static final String ANTOM_PUBLIC_KEY = ""; // public static final String MERCHANT_PRIVATE_KEY = ""; ## 4. Change the client joint debugging address HttpServer.java private static final String HOST_URL = "http://10.0.2.2:8080"; //Local IP or server address ## 5. Select the payment method to perform a payment test. ## tips: SDK integration requires first configuring the Podfile https://docs.antom.com/ac/sdks/android "pod mode requires account secret configuration" `] }, `Android-Java-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/android/kotlin/README.md', when: { platform: 'Android' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Directory demo description auto_debit //Signing withholding payment /api /sdk cashier_payment //Cashier payment /api /sdk easy_safe_pay //easypay subscription //subscription payment # Running conditions ## 1. Run the server code locally Select target and use cashier_payment_java api as an example. antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java ## 2. Change the service callback address`, '`alipayPayRequest.setPaymentRedirectUrl(', '"cashierapi://app/receivePayment?paymentRequestId=" + paymentRequestId);`', ` ## 3. Config merchant info antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java // public static final String CLIENT_ID = ""; // public static final String ANTOM_PUBLIC_KEY = ""; // public static final String MERCHANT_PRIVATE_KEY = ""; ## 4. Change the client joint debugging address HttpServer.java private static final String HOST_URL = "http://10.0.2.2:8080"; //Local IP or server address ## 5. Select the payment method to perform a payment test. ## tips: SDK integration requires first configuring the Podfile https://docs.antom.com/ac/sdks/android "pod mode requires account secret configuration" `] }, `Android-Kotlin-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/ios/objective-c/README.md', when: { platform: 'iOS' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Directory demo description auto_debit_sdk_objc auto_debit_api_objc //Signing withholding payment cashierpayment_api_objc cashierpayment_sdk_objc //Cashier payment easypay_objc //easypay subscription_payment_objc //subscription payment # Running conditions ## 1. Run the server code locally Select target and use cashier_payment_java api as an example. antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java ## 2. Change the service callback address`, '`alipayPayRequest.setPaymentRedirectUrl(', '"cashierpaymentapi://app/receivePayment?paymentRequestId=" + paymentRequestId);`', `## 3. Config merchant info antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java // public static final String CLIENT_ID = ""; // public static final String ANTOM_PUBLIC_KEY = ""; // public static final String MERCHANT_PRIVATE_KEY = ""; ## 4. Change the client joint debugging address HttpServer.m static NSString * const HOST_URL = @"http://127.0.0.1:8080"; //Local IP or server address ## 5. Select the payment method to perform a payment test. ## tips: SDK integration requires first configuring the Podfile https://docs.antom.com/ac/sdks/ios "pod mode requires account secret configuration" `] }, `iOS-Objective-C-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/ios/swift/README.md', when: { platform: 'iOS' }, children: _jsx(AntomFile, { language: `txt`, filename: 'client/README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# Directory demo description auto_debit_sdk_objc auto_debit_api_objc //Signing withholding payment cashierpayment_api_objc cashierpayment_sdk_objc //Cashier payment easypay_objc //easypay subscription_payment_objc //subscription payment # Running conditions ## 1. Run the server code locally Select target and use cashier_payment_java api as an example. antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java ## 2. Change the service callback address`, '`alipayPayRequest.setPaymentRedirectUrl(', '"cashierpaymentapi://app/receivePayment?paymentRequestId=" + paymentRequestId);`', `## 3. Config merchant info antom-online-payment-sample-java/src/main/java/com/antom/checkout/api/PaymentServer.java // public static final String CLIENT_ID = ""; // public static final String ANTOM_PUBLIC_KEY = ""; // public static final String MERCHANT_PRIVATE_KEY = ""; ## 4. Change the client joint debugging address HttpServer.m static NSString * const HOST_URL = @"http://127.0.0.1:8080"; //Local IP or server address ## 5. Select the payment method to perform a payment test. ## tips: SDK integration requires first configuring the Podfile https://docs.antom.com/ac/sdks/ios "pod mode requires account secret configuration" `] }, `iOS-Swift-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/python/README.md', when: { server: 'Python' }, children: _jsx(AntomFile, { language: `txt`, filename: 'README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# antom-online-payments-demo ## Getting Started This is a demo project to show how Antom payment works. For more detailed information, please visit [Antom Docs](https://docs.antom.com/) ## Requirements - Python 3.9 or later ## Config **Please make sure to replace the following parameters with your own to ensure correct integration.** Replace the following parameters in [server.py]()`, '- `CLIENT_ID`: Client ID', '- `ANTOM_PUBLIC_KEY`: Antom Public Key', "- `MERCHANT_PRIVATE_KEY`: Your Private Key (Antom won't save your private key, so you can't see it on dashboard, please refer [API key configuration](https://docs.antom.com/ac/ref/key_config))", ` `, 'You can find `CLIENT_ID` and `ANTOM_PUBLIC_KEY` on [Antom Dashboard](https://dashboard.antom.com/global-payments/developers/quickStart)', ` Follow the information below to configure the callback address information in server.py to ensure that the program works correctly. | platforms | product | integration types | redirectUrl | |-------------|----------------------|---------------------|------------------------------------------------------------------------------------------------------------| | Web | checkout payment | API/SDK/CKP/ELEMENT | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "http://localhost:5173/receiveAuthCode.html" | | | | SDK | authRedirectUrl: "http://localhost:5173/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "http://localhost:5173/index.html?subscriptionRequestId=" + subscriptionRequestId | | Android/iOS | checkout payment | API | paymentRedirectUrl: "cashierapi://app?paymentRequestId=" + paymentRequestId | | | | SDK | paymentRedirectUrl: "cashiersdk://app?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "autodebitapi://app/receiveAuthCode" | | | | SDK | authRedirectUrl: "autodebitsdk://app/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "easysafepay://app?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "subscription://app?subscriptionRequestId=" + subscriptionRequestId | ## Run You can run this demo in this way: 1. Build the server ~~~ pip3 install -r requirements.txt ~~~ 2. Run the server ~~~ export FLASK_APP=server.py python3 -m flask run --port=8080 ~~~ `] }, `server-Python-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/python/requirements.txt', when: { server: 'Python' }, children: _jsx(AntomFile, { language: `txt`, filename: 'requirements.txt', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`flask==3.1.0 global-open-sdk-python==1.4.23 real-money==0.1.0 Flask-Cors==4.0.0 `] }, `server-Python-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/java/README.md', when: { server: 'Java' }, children: _jsx(AntomFile, { language: `txt`, filename: 'README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# antom-online-payments-demo ## Getting Started This is a demo project to show how Antom payment works. For more detailed information, please visit [Antom Docs](https://docs.antom.com/) ## Requirements - Java 1.8 or later ## Config **Please make sure to replace the following parameters with your own to ensure correct integration.** Replace the following parameters in [PaymentServer.java]()`, '- `CLIENT_ID`: Client ID', '- `ANTOM_PUBLIC_KEY`: Antom Public Key', "- `MERCHANT_PRIVATE_KEY`: Your Private Key (Antom won't save your private key, so you can't see it on dashboard, please refer [API key configuration](https://docs.antom.com/ac/ref/key_config))", ` `, 'You can find `CLIENT_ID` and `ANTOM_PUBLIC_KEY` on [Antom Dashboard](https://dashboard.antom.com/global-payments/developers/quickStart)', ` Follow the information below to configure the callback address information in PaymentServer.java to ensure that the program works correctly. | platforms | product | integration types | redirectUrl | |----------------|----------------------|---------------------|------------------------------------------------------------------------------------------------------------| | Web(React/Vue) | checkout payment | API/SDK/CKP/ELEMENT | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "http://localhost:5173/receiveAuthCode.html" | | | | SDK | authRedirectUrl: "http://localhost:5173/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "http://localhost:5173/index.html?subscriptionRequestId=" + subscriptionRequestId | | Android/iOS | checkout payment | API | paymentRedirectUrl: "cashierapi://app?paymentRequestId=" + paymentRequestId | | | | SDK | paymentRedirectUrl: "cashiersdk://app?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "autodebitapi://app/receiveAuthCode" | | | | SDK | authRedirectUrl: "autodebitsdk://app/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "easysafepay://app?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "subscription://app?subscriptionRequestId=" + subscriptionRequestId | ## Run You can run this demo in two ways: ### Start Locally Start application by running [PaymentServer.java]() After start, visit demo page in browser：[http://localhost:8080](http://localhost:8080) ### Package & Run 1. package project `, ' ``` shell', ` mvn clean package`, ' ```', ` 2. run server `, ' ``` shell', ` java -jar ./target/antom-sample-code-0.0.1.jar`, ' ```', ` `] }, `server-Java-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/java/pom.xml', when: { server: 'Java' }, children: _jsx(AntomFile, { language: `txt`, filename: 'pom.xml', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [` 4.0.0 org.springframework.boot spring-boot-starter-parent 2.7.6 com.antom.global.payment antom-sample-code 0.0.1 antom Demo project for antom payment demo 1.8 org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-web org.joda joda-money 1.0.4 com.alipay.global.sdk global-open-sdk-java 2.1.4 com.alibaba fastjson 1.2.83 org.projectlombok lombok 1.18.30 provided javax.xml.bind jaxb-api 2.3.0 org.springframework.boot spring-boot-maven-plugin `] }, `server-Java-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/php/README.md', when: { server: 'PHP' }, children: _jsx(AntomFile, { language: `txt`, filename: 'README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# antom-online-payments-demo ## Getting Started This is a demo project to show how Antom payment works. For more detailed information, please visit [Antom Docs](https://docs.antom.com/) ## Requirements - PHP 5.6 or later ## Config **Please make sure to replace the following parameters with your own to ensure correct integration.** Replace the following parameters in [server.php]()`, '- `CLIENT_ID`: Client ID', '- `ANTOM_PUBLIC_KEY`: Antom Public Key', "- `MERCHANT_PRIVATE_KEY`: Your Private Key (Antom won't save your private key, so you can't see it on dashboard, please refer [API key configuration](https://docs.antom.com/ac/ref/key_config))", ` `, 'You can find `CLIENT_ID` and `ANTOM_PUBLIC_KEY` on [Antom Dashboard](https://dashboard.antom.com/global-payments/developers/quickStart)', ` Follow the information below to configure the callback address information in server.php to ensure that the program works correctly. | platforms | product | integration types | redirectUrl | |-------------|----------------------|---------------------|------------------------------------------------------------------------------------------------------------| | Web | checkout payment | API/SDK/CKP/ELEMENT | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "http://localhost:5173/receiveAuthCode.html" | | | | SDK | authRedirectUrl: "http://localhost:5173/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "http://localhost:5173/index.html?subscriptionRequestId=" + subscriptionRequestId | | Android/iOS | checkout payment | API | paymentRedirectUrl: "cashierapi://app?paymentRequestId=" + paymentRequestId | | | | SDK | paymentRedirectUrl: "cashiersdk://app?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "autodebitapi://app/receiveAuthCode" | | | | SDK | authRedirectUrl: "autodebitsdk://app/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "easysafepay://app?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "subscription://app?subscriptionRequestId=" + subscriptionRequestId | ## Run You can run this demo in this way: 1. Build the server ~~~ composer install ~~~ 2. Run the server ~~~ php -S 127.0.0.1:8080 server.php ~~~ `] }, `server-PHP-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/php/composer.json', when: { server: 'PHP' }, children: _jsx(AntomFile, { language: `txt`, filename: 'composer.json', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`{ "require": { "antom/global-open-sdk-php": "1.4.23", "moneyphp/money": "^3.3", "slim/slim": "2.6.3", "ext-json": "*" }, "config": { "allow-plugins": { "kylekatarnls/update-helper": true } } } `] }, `server-PHP-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/go/README.md', when: { server: 'Go' }, children: _jsx(AntomFile, { language: `txt`, filename: 'README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# antom-online-payments-demo ## Getting Started This is a demo project to show how Antom payment works. For more detailed information, please visit [Antom Docs](https://docs.antom.com/) ## Requirements - Go 1.22.5 or later ## Config **Please make sure to replace the following parameters with your own to ensure correct integration.** Replace the following parameters in [server.go]()`, '- `CLIENT_ID`: Client ID', '- `ANTOM_PUBLIC_KEY`: Antom Public Key', "- `MERCHANT_PRIVATE_KEY`: Your Private Key (Antom won't save your private key, so you can't see it on dashboard, please refer [API key configuration](https://docs.antom.com/ac/ref/key_config))", ` `, 'You can find `CLIENT_ID` and `ANTOM_PUBLIC_KEY` on [Antom Dashboard](https://dashboard.antom.com/global-payments/developers/quickStart)', ` Follow the information below to configure the callback address information in server.go to ensure that the program works correctly. | platforms | product | integration types | redirectUrl | |-------------|----------------------|---------------------|------------------------------------------------------------------------------------------------------------| | Web | checkout payment | API/SDK/CKP/ELEMENT | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "http://localhost:5173/receiveAuthCode.html" | | | | SDK | authRedirectUrl: "http://localhost:5173/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "http://localhost:5173/index.html?subscriptionRequestId=" + subscriptionRequestId | | Android/iOS | checkout payment | API | paymentRedirectUrl: "cashierapi://app?paymentRequestId=" + paymentRequestId | | | | SDK | paymentRedirectUrl: "cashiersdk://app?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "autodebitapi://app/receiveAuthCode" | | | | SDK | authRedirectUrl: "autodebitsdk://app/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "easysafepay://app?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "subscription://app?subscriptionRequestId=" + subscriptionRequestId | ## Run You can run this demo in this way: 1. Run the server ~~~ go run server.go ~~~ `] }, `server-Go-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/go/go.mod', when: { server: 'Go' }, children: _jsx(AntomFile, { language: `txt`, filename: 'go.mod', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`module antom-online-payment-sample-go go 1.22.5 require ( github.com/Rhymond/go-money v1.0.14 github.com/alipay/global-open-sdk-go v1.2.34 github.com/google/uuid v1.6.0 ) `] }, `server-Go-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/.net/README.md', when: { server: '.NET' }, children: _jsx(AntomFile, { language: `txt`, filename: 'README.md', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [`# antom-online-payments-demo ## Getting Started This is a demo project to show how Antom payment works. For more detailed information, please visit [Antom Docs](https://docs.antom.com/) ## Requirements - .NET 8.0 or later ## Config **Please make sure to replace the following parameters with your own to ensure correct integration.** Replace the following parameters in [server.cs]()`, '- `CLIENT_ID`: Client ID', '- `ANTOM_PUBLIC_KEY`: Antom Public Key', "- `MERCHANT_PRIVATE_KEY`: Your Private Key (Antom won't save your private key, so you can't see it on dashboard, please refer [API key configuration](https://docs.antom.com/ac/ref/key_config))", ` `, 'You can find `CLIENT_ID` and `ANTOM_PUBLIC_KEY` on [Antom Dashboard](https://dashboard.antom.com/global-payments/developers/quickStart)', ` Follow the information below to configure the callback address information in server.cs to ensure that the program works correctly. | platforms | product | integration types | redirectUrl | |----------------|----------------------|---------------------|------------------------------------------------------------------------------------------------------------| | Web(React/Vue) | checkout payment | API/SDK/CKP/ELEMENT | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "http://localhost:5173/receiveAuthCode.html" | | | | SDK | authRedirectUrl: "http://localhost:5173/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "http://localhost:5173/index.html?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "http://localhost:5173/index.html?subscriptionRequestId=" + subscriptionRequestId | | Android/iOS | checkout payment | API | paymentRedirectUrl: "cashierapi://app?paymentRequestId=" + paymentRequestId | | | | SDK | paymentRedirectUrl: "cashiersdk://app?paymentRequestId=" + paymentRequestId | | | auto debit | API | authRedirectUrl: "autodebitapi://app/receiveAuthCode" | | | | SDK | authRedirectUrl: "autodebitsdk://app/receiveAuthCode" | | | easysafepay | SDK | paymentRedirectUrl: "easysafepay://app?paymentRequestId=" + paymentRequestId | | | subscription payment | API | subscriptionRedirectUrl: "subscription://app?subscriptionRequestId=" + subscriptionRequestId | ## Run You can run this demo in this way: 1. Build the server ~~~ dotnet restore ~~~ 2. Run the server ~~~ dotnet run ~~~ `] }, `server-.NET-API-other1`) }) }), _jsx(AntomPartial, { file: 'integration-builder/antom/files/server/.net/antom-online-payment-sample-dotnet.csproj', when: { server: '.NET' }, children: _jsx(AntomFile, { language: `txt`, filename: 'antom-online-payment-sample-dotnet.csproj', downloadOnly: true, steps: [], children: _jsx(AntomChunk, { language: `txt`, steps: [``], chunks: [` net8.0 enable enable antom_online_payment_sample_dotnet `] }, `server-.NET-API-other1`) }) })] }) }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = props.components || ({}); return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }

Quick start