Server API version 1.0


Third party status poll

GET https://{domainname}/v1/{merchantId}/payments/{paymentId}/thirdpartystatus


The payments REST services allow you to initiate a payment, retrieve the payment details or perform specific actions like refunding or requesting capture of a payment. A payment is identified by its paymentId. Some payment products allow a two step approach allowing you to control when the authorization takes place separate from when the funds are actually captured.


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: Node.js

This scenario you will probably use the most

  • connectSdk.payments.thirdPartyStatus("merchantId", "paymentId", null, function (error, sdkResponse) {
      // if sdkResponse is not null, it has the following properties:
      // - status: the HTTP status code
      // - body: the response body
      // - isSuccess: true if the call was successful,
      //              or false if the Ingenico ePayments platform returned an error response


Please find below an overview of the possible responses.

Response 200 - OKThirdPartyStatusResponse

The response contains the current third party status.

Property Type Required Details
thirdPartyStatus string no read close


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: Node.js

This scenario you will probably use the most

  • {
        "thirdPartyStatus" : "WAITING"