iOS Payment Links
Implement the Callbacks
To implement the iOS Mobile Checkout SDK, include the following callback methods:
Method | Description | Argument | Type |
---|---|---|---|
onInitialized | Triggered when SDK initialization was successful. | ||
onInitializeFailed | Triggered when SDK initialization failed. | ||
onPurchaseSuccess | Triggered when a purchase was successful. | order | OrderResponseModel |
onPurchaseFailed | Triggered when the checkout window closed or if a server to server error occurred during the purchasing process. Returns a unique integer error code, a detailed message, and a raw JSON string (if available) with more details. | error | ACErrorMessage |
The OrderResponseModel
argument contains the following properties:
Property Name | Type | Description | Example |
---|---|---|---|
date | Int | Unix timestamp of the order. | 1718182312 |
sessionToken | String | Unique token for the current session. | "xxxxXXXXxxxxXXXXxxxx" |
offerName | String | Name of the purchased offer. | "Starter Pack" |
offerSku | String | SKU identifier for the offer. | "starter_pack_001" |
items | [Item] | List of items included in the purchase. | [{ name: "Gems", sku: "gem_01", quantity: "100" }] |
items.name | String | Display name of the item. | "Gems" |
items.sku | String | Unique SKU code for the item. | "gem_01" |
items.quantity | String | Quantity of the item included. | "100" |
price | Int | Price of the order in minor units. For example, cents for USD. | 499 |
currency | String | ISO 4217 currency code | "USD" |
customerId | String | ID of the customer who made the purchase. | "cust_98765" |
customerCountry | String | Country code of the customer in ISO 3166-1 alpha-2 format. | "US" |
paymentMethodName | String | Payment method. | "Visa" |
orderId | String | Order ID. | "1234567890" |
purchaseId | String | A unique ID to track the transaction. | "pr_xxxxxx" |