{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Aeropay onboarding","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"aeropay-onboarding","__idx":0},"children":["Aeropay onboarding"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure Aeropay in the Unity Portal and connect your merchant account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you haven't already, make sure that you have activated the Components service in the Unity Portal. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/activate"},"children":["Activate Components"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll also need the following account details, provided by Aeropay:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API secret"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configuration ID"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-ensure-aeropay-is-enabled-at-the-merchant-group-level","__idx":2},"children":["Step 1: Ensure Aeropay is enabled at the merchant group level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aeropay must be enabled for your merchant group before it can be configured on individual sites."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Merchant groups"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your merchant group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab, find ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Aeropay service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If Aeropay is not listed, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add service"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aeropay"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-get-your-pxp-api-credentials","__idx":3},"children":["Step 2: Get your PXP API credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your backend needs API credentials to create checkout sessions with HMAC authentication."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Merchant groups"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your merchant group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inbound calls"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," shown in the top-right corner."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ New token"]}," to create an authentication token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose an expiry period and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy both the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token value"]},". Store these securely on your backend."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never expose your token value or HMAC credentials in your iOS app. Session creation must happen on your backend."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-configure-aeropay-on-your-site","__idx":4},"children":["Step 3: Configure Aeropay on your site"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add your Aeropay account details to each site where you'll accept Aeropay payments or payouts."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Sites"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the site you want to enable Aeropay for."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Aeropay service"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API secret"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configuration ID"]}," provided by Aeropay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," in the top right."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-verify-session-configuration","__idx":5},"children":["Step 4: Verify session configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After saving your Aeropay account settings, create a test session from your backend and confirm that Aeropay is included in the response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The session request must enable Aeropay. Use the following checklist:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the correct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site"]}," IDs for the Aeropay-enabled site."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amounts.currencyCode"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a supported Aeropay intent under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionMethod.intent.aeropay"]},", for example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"transactionMethod\": {\n  \"intent\": {\n    \"aeropay\": \"Authorisation\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported intent values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorisation"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Purchase"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EstimatedAuthorisation"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]},". For the full HMAC and session walkthrough, see the iOS ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/install#step-3-get-the-session-data"},"children":["install guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Portal field names for the site Aeropay service map to these session properties:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Unity Portal (site Aeropay service)"},"children":["Unity Portal (site Aeropay service)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Session response ( allowedFundingTypes.payByBanks.aeropay )"},"children":["Session response (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.payByBanks.aeropay"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalMerchantId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configuration ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configurationId"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API key and API secret are stored in the portal for backend and provider use. The iOS SDK only needs non-empty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalMerchantId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configurationId"]}," at component creation. It doesn't read ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiSecret"]}," from the session on the client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A correctly configured session includes Aeropay pay-by-bank settings:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"sessionId\": \"c5f0799b-0839-43ce-abc5-5b462a98f250\",\n  \"hmacKey\": \"904bc42395d4af634e2fd48ee8c2c7f52955a1da97a3aa3d82957ff12980a7bb\",\n  \"encryptionKey\": \"20d175a669ad3f8c195c9c283fc86155\",\n  \"allowedFundingTypes\": {\n    \"payByBanks\": {\n      \"aeropay\": {\n        \"externalMerchantId\": \"your-aeropay-merchant-id\",\n        \"configurationId\": \"your-aerosync-configuration-id\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.payByBanks.aeropay"]}," is missing, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalMerchantId"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["configurationId"]}," is empty, the SDK throws ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0113"]}," when you create the component. The SDK message is generic: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Aeropay is missing in allow funding types."]}," It doesn't name the missing field, so inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.payByBanks.aeropay"]}," in the session response. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/aeropay/troubleshooting#portal-and-session-setup"},"children":["Portal and session setup"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whats-next","__idx":6},"children":["What's next?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/aeropay/implementation"},"children":["Implementation"]},":"]}," Integrate the Aeropay button into your iOS app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/aeropay/testing"},"children":["Testing"]},":"]}," Test your integration in the sandbox environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/aeropay/how-it-works"},"children":["How it works"]},":"]}," Understand the Aeropay payment and payout flows."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you run into setup issues, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/ios/aeropay/troubleshooting#portal-and-session-setup"},"children":["Portal and session setup"]}," in Troubleshooting."]}]},"headings":[{"value":"Aeropay onboarding","id":"aeropay-onboarding","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Step 1: Ensure Aeropay is enabled at the merchant group level","id":"step-1-ensure-aeropay-is-enabled-at-the-merchant-group-level","depth":2},{"value":"Step 2: Get your PXP API credentials","id":"step-2-get-your-pxp-api-credentials","depth":2},{"value":"Step 3: Configure Aeropay on your site","id":"step-3-configure-aeropay-on-your-site","depth":2},{"value":"Step 4: Verify session configuration","id":"step-4-verify-session-configuration","depth":2},{"value":"What's next?","id":"whats-next","depth":2}],"frontmatter":{"seo":{"title":"Aeropay onboarding"}},"lastModified":"2026-08-10T16:34:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/ios/aeropay/onboarding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}