--- page_source: https://docs.juspay.io/hypercheckout/ios/base-sdk-integration/handle-payment-response page_title: 4. Handle Payment Response --- # 4. Handle Payment Response ### Step 4.1. Handle Payment Response from SDK All payment responses are sent by the SDK in the HyperPaymentCallbackHandler under the `process_result` event. Implement the highlighted code snippet in your app for proper handling of all events and status #### Code Snippets: - #### Swift Code Snippet: ```swift else if event == "process_result" { let error = data["error"] as? Bool ?? false if let innerPayload = data["payload"] as? [String: Any] { let status = innerPayload["status"] as? String let pi = innerPayload["paymentInstrument"] as? String let pig = innerPayload["paymentInstrumentGroup"] as? String let storyboard = UIStoryboard(name: "Main", bundle: nil) if !error { performSegue(withIdentifier: "statusSegue", sender: status) // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { let errorCode = data["errorCode"] as? String let errorMessage = data["errorMessage"] as? String switch status! { case "backpressed": // user back-pressed from PP without initiating any txn let alertController = UIAlertController(title: "Payment Cancelled", message: "User clicked back button on Payment Page", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "user_aborted": // user initiated a txn and pressed back // poll order status let alertController = UIAlertController(title: "Payment Aborted", message: "Transaction aborted by user", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "pending_vbv", "authorizing": performSegue(withIdentifier: "statusSegue", sender: status) // txn in pending state // poll order status until backend says fail or success break case "authorization_failed", "authentication_failed", "api_failure": performSegue(withIdentifier: "statusSegue", sender: status) // txn failed // poll orderStatus to verify (false negatives) break case "new": performSegue(withIdentifier: "statusSegue", sender: status) // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status break default: performSegue(withIdentifier: "statusSegue", sender: status) // unknown status, this is also failure // poll order status break } } } } ``` #### ObjectiveC Code Snippet: ```objectivec else if ([event isEqualToString:@"process_result"]) { BOOL error = [data[@"error"] boolValue]; NSDictionary *innerPayload = data[@"payload"]; NSString *status = innerPayload[@"status"]; NSString *pi = innerPayload[@"paymentInstrument"]; NSString *pig = innerPayload[@"paymentInstrumentGroup"]; if (!error) { // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { NSString *errorCode = data[@"errorCode"]; NSString *errorMessage = data[@"errorMessage"]; if([status isEqualToString:@"backpressed"]) { // user back-pressed from PP without initiating any txn } else if ([status isEqualToString:@"backpressed"]) { // user initiated a txn and pressed back // poll order status } else if ([status isEqualToString:@"pending_vbv"] || [status isEqualToString:@"authorizing"]) { // txn in pending state // poll order status until backend says fail or success } else if ([status isEqualToString:@"authorization_failed"] || [status isEqualToString:@"authentication_failed"] || [status isEqualToString:@"api_failure"]) { // txn failed // poll orderStatus to verify (false negatives) } else if([status isEqualToString:@"new"]) { // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status } else { // unknown status, this is also failure // poll order status } } } ``` ### Step 4.2. Check Order Status After receiving `process_result` from SDK, it is mandatory to do a Server-to-Server Order Status API call to determine the final payment status. Please ensure that you verify the order ID and amount transaction. To understand how to handle payment status, [refer to this section.](/hyper-checkout/ios/resources/transaction-status) ![Image](/images/payment_status_handling.png) #### Code Snippets: - #### Swift Code Snippet: ```swift else if event == "process_result" { let error = data["error"] as? Bool ?? false if let innerPayload = data["payload"] as? [String: Any] { let status = innerPayload["status"] as? String let pi = innerPayload["paymentInstrument"] as? String let pig = innerPayload["paymentInstrumentGroup"] as? String let storyboard = UIStoryboard(name: "Main", bundle: nil) if !error { performSegue(withIdentifier: "statusSegue", sender: status) // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { let errorCode = data["errorCode"] as? String let errorMessage = data["errorMessage"] as? String switch status! { case "backpressed": // user back-pressed from PP without initiating any txn let alertController = UIAlertController(title: "Payment Cancelled", message: "User clicked back button on Payment Page", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "user_aborted": // user initiated a txn and pressed back // poll order status let alertController = UIAlertController(title: "Payment Aborted", message: "Transaction aborted by user", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "pending_vbv", "authorizing": performSegue(withIdentifier: "statusSegue", sender: status) // txn in pending state // poll order status until backend says fail or success break case "authorization_failed", "authentication_failed", "api_failure": performSegue(withIdentifier: "statusSegue", sender: status) // txn failed // poll orderStatus to verify (false negatives) break case "new": performSegue(withIdentifier: "statusSegue", sender: status) // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status break default: performSegue(withIdentifier: "statusSegue", sender: status) // unknown status, this is also failure // poll order status break } } } } ``` #### ObjectiveC Code Snippet: ```objectivec else if ([event isEqualToString:@"process_result"]) { BOOL error = [data[@"error"] boolValue]; NSDictionary *innerPayload = data[@"payload"]; NSString *status = innerPayload[@"status"]; NSString *pi = innerPayload[@"paymentInstrument"]; NSString *pig = innerPayload[@"paymentInstrumentGroup"]; if (!error) { // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { NSString *errorCode = data[@"errorCode"]; NSString *errorMessage = data[@"errorMessage"]; if([status isEqualToString:@"backpressed"]) { // user back-pressed from PP without initiating any txn } else if ([status isEqualToString:@"backpressed"]) { // user initiated a txn and pressed back // poll order status } else if ([status isEqualToString:@"pending_vbv"] || [status isEqualToString:@"authorizing"]) { // txn in pending state // poll order status until backend says fail or success } else if ([status isEqualToString:@"authorization_failed"] || [status isEqualToString:@"authentication_failed"] || [status isEqualToString:@"api_failure"]) { // txn failed // poll orderStatus to verify (false negatives) } else if([status isEqualToString:@"new"]) { // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status } else { // unknown status, this is also failure // poll order status } } } ``` ### Step 4.3. Display Payment Status Once the payment status is determined via the API, the final status should be displayed to the user. This screen needs to be handled by the merchant, it is not provided by the SDK #### Code Snippets: - #### Swift Code Snippet: ```swift else if event == "process_result" { let error = data["error"] as? Bool ?? false if let innerPayload = data["payload"] as? [String: Any] { let status = innerPayload["status"] as? String let pi = innerPayload["paymentInstrument"] as? String let pig = innerPayload["paymentInstrumentGroup"] as? String let storyboard = UIStoryboard(name: "Main", bundle: nil) if !error { performSegue(withIdentifier: "statusSegue", sender: status) // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { let errorCode = data["errorCode"] as? String let errorMessage = data["errorMessage"] as? String switch status! { case "backpressed": // user back-pressed from PP without initiating any txn let alertController = UIAlertController(title: "Payment Cancelled", message: "User clicked back button on Payment Page", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "user_aborted": // user initiated a txn and pressed back // poll order status let alertController = UIAlertController(title: "Payment Aborted", message: "Transaction aborted by user", preferredStyle: .alert) let okAction = UIAlertAction(title: "OK", style: .default, handler: nil) alertController.addAction(okAction) present(alertController, animated: true, completion: nil) break case "pending_vbv", "authorizing": performSegue(withIdentifier: "statusSegue", sender: status) // txn in pending state // poll order status until backend says fail or success break case "authorization_failed", "authentication_failed", "api_failure": performSegue(withIdentifier: "statusSegue", sender: status) // txn failed // poll orderStatus to verify (false negatives) break case "new": performSegue(withIdentifier: "statusSegue", sender: status) // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status break default: performSegue(withIdentifier: "statusSegue", sender: status) // unknown status, this is also failure // poll order status break } } } } ``` #### ObjectiveC Code Snippet: ```objectivec else if ([event isEqualToString:@"process_result"]) { BOOL error = [data[@"error"] boolValue]; NSDictionary *innerPayload = data[@"payload"]; NSString *status = innerPayload[@"status"]; NSString *pi = innerPayload[@"paymentInstrument"]; NSString *pig = innerPayload[@"paymentInstrumentGroup"]; if (!error) { // txn success, status should be "charged" // process data -- show pi and pig in UI maybe also? // example -- pi: "PAYTM", pig: "WALLET" // call orderStatus once to verify (false positives) } else { NSString *errorCode = data[@"errorCode"]; NSString *errorMessage = data[@"errorMessage"]; if([status isEqualToString:@"backpressed"]) { // user back-pressed from PP without initiating any txn } else if ([status isEqualToString:@"backpressed"]) { // user initiated a txn and pressed back // poll order status } else if ([status isEqualToString:@"pending_vbv"] || [status isEqualToString:@"authorizing"]) { // txn in pending state // poll order status until backend says fail or success } else if ([status isEqualToString:@"authorization_failed"] || [status isEqualToString:@"authentication_failed"] || [status isEqualToString:@"api_failure"]) { // txn failed // poll orderStatus to verify (false negatives) } else if([status isEqualToString:@"new"]) { // order created but txn failed // very rare for V2 (signature based) // also failure // poll order status } else { // unknown status, this is also failure // poll order status } } } ```