This site requires javascript to be enabled.

Results for

xxx

Third party status poll

GET https://{domainname}/client/v1/{customerId}/payments/{paymentId}/thirdpartystatus

Payments

Through this API you can retrieve information that is specific to a payment.

Request

Polls a third party for the status of the payment.

Currently only available for payments performed with payment products 3012 (Bancontact) and 863 (WeChat Pay). In the case of Bancontact, it is used to determine if the customer is paying using the Bancontact app and if so, what the payment status is.

Request example

SDK: iOS

This scenario you will probably use the most

  • NSString *clientSessionId = @"<clientSessionId from Create Session>";
    NSString *customerId = @"<customerId from Create Session>";
    NSString *baseURL = @"<clientApiUrl from Create Session>";
    NSString *assetBaseURL = @"<assetUrl from Create Session>";
    NSString *appIdentifier = @"<your app name>";
    
    ICSession *session = [ICSession sessionWithClientSessionId:clientSessionId
                                                    customerId:customerId
                                                       baseURL:baseURL
                                                  assetBaseURL:assetBaseURL
                                                 appIdentifier:appIdentifier];
    
    // Retrieve this ID with a createPayment call that you have done via the S2S API
    NSString *paymentId = @"<id of the current payment>";
    
    [session thirdPartyStatusForPayment:paymentId success:^(ICThirdPartyStatusResponse *thirdPartyStatusResponse) {
        // Process third party  	status
    } failure:^(NSError *error) {
        DLog(@"Error while retrieving third party payment status: %@, [error localizedDescription]);
    }];
    

Responses

Please find below an overview of the possible responses.

Response 200 - OKThirdPartyStatusResponse

The response contains the current third party status.

Properties
Property Type Required Details
close

Description

The status returned by the third party. Possible values:
  • WAITING - The customer has not connected to the third party
  • INITIALIZED - Authentication in progress
  • AUTHORIZED - Payment in progress
  • COMPLETED - The customer has completed the payment at the third party

Response example

SDK: iOS

This scenario you will probably use the most

  • {
        "thirdPartyStatus" : "WAITING"
    }