iOS

Prebuilt checkout page

1.Create a Customer

Pass a customerId to MoneyCollect to attach to the customer.

   // Use your customerId 
   var customerId = "cus_1452880617225281538"

2.Construct data, and pay in PaymentSheet model

When creating a payment method, you can specify customer parameters and automatically attach the payment method to an existing customer.

  /** Merchant ID */
   @property (nonatomic,copy) NSString *customerID;
   /** Billing details */
   @property (nonatomic,strong) MCBillingDetails *billingDetails;
   /** Create payment parameter object */
   @property (nonatomic,strong) MCCreatePaymentParams *createPaymentParams;


    // Initiate controller
    MCSelectPaymentCardVC *selectPaymentCardVC = [[MCSelectPaymentCardVC alloc] init];
    selectPaymentCardVC.delegate = self;

    // Build request parameters
    selectPaymentCardVC.customerID = [MCConfigurationFile getCustomerID];
    selectPaymentCardVC.billingDetails = [MCConfigurationFile getBillingDetailsModel];
    selectPaymentCardVC.createPaymentParams = [self constructMCCreatePaymentParams];
    
    // Display view
    [selectPaymentCardVC present:self];

The details of using constructMCCreatePaymentParams method to construct data, please refer to MCPaymentSheetCheckoutVC class under Example.

3.Start Hosted Payment Page mode

• Tap “Checkout” button to pay in Hosted Payment Page mode.

• In Hosted payment page，select the previously saved card or add a new card.

• Finally, tap the PayNow button to complete the payment.

4.Customer selects "save this card" during payment

• 4.1 Select "Save this card for your future use" on the Add a card page.

NSString *setupFutureUsage = isSelected ? @"on" : @"off";
_createPaymentParams.setupFutureUsage = setupFutureUsage;

Select the payment card in the future, when using setupFutureUsage set to "on", otherwise to "off"

• 4.2 Click "Add a card.

• 4.3 After create a payment method and attach the payment method to customer will save the card details to customer.

5.Return the payment result

@protocol MCSelectPaymentCardVCDelegate <NSObject>
/** Agent method for successful transaction */
- (void)successfulTransactionWithResponseObject:(NSDictionary *_Nullable)responseObject;
@end;

#pragma mark - MCSelectPaymentCardVCDelegate
- (void)successfulTransactionWithResponseObject:(NSDictionary *)responseObject
{
    // Transaction status
    NSString *status = [[responseObject objectForKey:@"data"] objectForKey:@"status"];
    
    if ([status isEqualToString:@"succeeded"]) {
        
        NSLog(@"success");
        
    }else if ([status isEqualToString:@"failed"]) {
        
        NSLog(@"%@",[[responseObject objectForKey:@"data"] objectForKey:@"errorMessage"]);
        
    }else if ([status isEqualToString:@"pending"]) {
        
        NSLog(@"pending");
        
    }else if ([status isEqualToString:@"uncaptured"]) {
        
        NSLog(@"uncaptured");
        
    }else if ([status isEqualToString:@"canceled"]) {
        
        NSLog(@"canceled");
        
    }else {
        
        NSLog(@"pending");
        
    }
}

Custom payment flow

1.Create a Customer

Pass a customerId to MoneyCollect to attach to the customer.

   // Use your customerId 
   var customerId = "cus_1452880617225281538"

2.Construct data, and add payment methods with PaymentSheet customizable models

When creating a payment method, you can specify customer parameters to automatically attach the payment method to an existing customer.

#pragma mark - Button Click Event
- (void)selectCardButtonClick:(UIButton *)sender
{
    // Initiate objective
    MCAddCardViewController *addCardVC = [[MCAddCardViewController alloc] init];
    addCardVC.delegate = self;
    
    // Construct parameter
    addCardVC.customerID = [MCConfigurationFile getCustomerID];
    
    //Display view
    [addCardVC present:self];
    
}

3.Customer selects save this card during payment

• 3.1 Select Save this card for your future use on the Add a card page.

   if (isSelected) { // Save card details
    [[MCAPIClient shared] attachPaymentMethodToCustomer:[MCConfigurationFile getCustomerID] paymentMethod:ID completionBlock:^(NSDictionary * _Nullable responseObject, NSError * _Nullable error) {
       if (!error) { // Request succeeded
          NSLog(@"Save card(Add a card,Add payment methods):%@",responseObject);
       }else {
          NSLog(@"failed to save this card,code = %ld error message = %@",error.code,error.localizedDescription);
       }
      }];
     }

Select the payment card in the future, when setupFutureUsage set to on, otherwise it will set to off.

• 3.2 Click Add a card.

• 3.3 After create a payment method and attach the payment method to customer will save the card details to customer.

4.Customer selects the card to make payment

Click on the Pay Now button to complete the transaction.

5.Return the payment result

The payment result is obtained by calling the confirmPayment API for payment confirmation, and then the result data is passed to the component.

  [[MCAPIClient shared] confirmPaymentWithParams:params completionBlock:^(NSDictionary * _Nullable responseObject, NSError * _Nullable error) {
                
                    if (!error) { // Request succeeded
                        
                        // Determine whether to trigger 3D Secure authentication
                        NSDictionary *nextAction = [[responseObject objectForKey:@"data"] objectForKey:@"nextAction"];
                        
                        if (nextAction) { // If this object exists, will trigger 3D Secure authentication
                            
                            NSString *redirectToUrl = [nextAction objectForKey:@"redirectToUrl"];
                            NSString *paymentID = [[responseObject objectForKey:@"data"] objectForKey:@"id"];
                            NSString *clientSecret = [[responseObject objectForKey:@"data"] objectForKey:@"clientSecret"];
                            
                            // Load 3D secure page
                            MCThreeDSWebViewController *threeDSVC = [[MCThreeDSWebViewController alloc] init];
                            [threeDSVC loadURL:redirectToUrl paymentID:paymentID clientSecret:clientSecret];
                            
                            threeDSVC.completeBlock = ^(NSString *msg, NSDictionary *responseObject){
                                
                                // Eliminate animation
                                [weakSelf requestCompletedMsg:msg];
                                
                            };
                            
                            [weakSelf presentViewController:threeDSVC animated:YES completion:nil];
                            
                        }else { // Ordinary transaction
                            
                            // Transaction status
                            NSString *status = [[responseObject objectForKey:@"data"] objectForKey:@"status"];
                            // Hint
                            NSString *msg = @"";
                            
                            if ([status isEqualToString:@"succeeded"]) {
                                
                                msg = @"success";
                                
                            }else if ([status isEqualToString:@"failed"]) {
                                
                                msg = [[responseObject objectForKey:@"data"] objectForKey:@"errorMessage"];
                                
                            }else if ([status isEqualToString:@"pending"]) {
                                
                                msg = @"the payment is pending";
                                
                            }else if ([status isEqualToString:@"uncaptured"]) {
                                
                                msg = @"the payment is uncaptured";
                                
                            }else if ([status isEqualToString:@"canceled"]) {
                                
                                msg = @"the payment is canceled";
                                
                            }else {
                                
                                msg = @"the payment is pending";
                                
                            }
                            
                            // Eliminate animation
                            [weakSelf requestCompletedMsg:msg];
                        }
                    
                        NSLog(@"Confirm charge:%@",responseObject);
                        
                    }else { // Request failed
                        
                        // Eliminate animation
                        [weakSelf requestCompletedMsg:error.localizedDescription];
                        
                        NSLog(@"failed to confirm charge,code = %ld Error message = %@",error.code,error.localizedDescription);
                    }
                                
                }];


#pragma mark - End
- (void)requestCompletedMsg:(NSString *)msg
{
    _bottomPayNow.msg = msg;
    
    __weak typeof(self) weakSelf = self;
    [UIView animateWithDuration:0.25 animations:^{
        weakSelf.bottomView.y -= weakSelf.bottomPayNow.textH;
        weakSelf.bottomView.height += weakSelf.bottomPayNow.textH;
    }];
}