Format of callback with the payment result

The payment platform sends to your web service a callback with customer redirection data as described in more details in Callbacks.

If the payment processing uses the 3‑D Secure 2 authentication, callbacks may contain the mpi_result object which includes the following parameters:

  • mpi_operation_id—operation ID on the 3DS Server side
  • ds_operation_id—operation ID on the Directory Server side of the global payment system
  • acs_operation_id—operation ID on the Access Control Server of the issuer
  • mpi_timestamp—authentication time and date
  • cardholder_info—a copy of the message it is recommended to display when notifying the customer about the authentication result
  • authentication_flow—challenge flow indicator: 01 for frictionless flow, 02 for challenge flow.

To implement the receipt of these parameters, contact the support service at support@ecommpay.com

Figure: Example of callback with the result of a payment performed by using 3‑D Secure 2

{  
  "account":{  
    "number":"424242******4243",
    "token":"f365bb1729f9b72fd9c09703a751c979f3becc679f29c3e35c91d18070d15654",
    "type":"visa",
    "card_holder":"JUDY DOE",
    "id":45678,
    "expiry_month":"08",
    "expiry_year":"2025"
  },
  "customer":{  
    "id":"customer_12",
    "phone":"44991234567"
  },
  "payment":{  
    "date":"2019-01-11T13:02:42+0000",
    "id":"456789",
    "method":"card",
    "status":"success",
    "sum":{  
      "amount":400000,
      "currency":"USD"
    },
    "type":"purchase",
    "description":""
  },
  "project_id":42,
  "operation":{  
    "id":969000002636,
    "type":"sale",
    "status":"success",
    "date":"2019-01-11T13:02:42+0000",
    "created_date":"2019-01-11T13:01:45+0000",
    "request_id":"c6eed1eb14c629b4ef20b3b8086d...d04132c34b0088cbc0be4667c",
    "sum_initial":{  
      "amount":400000,
      "currency":"USD"
    },
    "sum_converted":{  
      "amount":400000,
      "currency":"USD"
    },
    "provider":{  
      "id":408,
      "payment_id":"330157196",
      "date":"2019-01-11T13:02:32+0000",
      "auth_code":"",
      "endpoint_id":"612266625"
    },
    "mpi_result":{
     "mpi_operation_id": "",  // Operation ID on the 3DS Server side
     "ds_operation_id": "",   // Operation ID on the Directory Server of the global payment system 
     "acs_operation_id": "",  // Operation ID on the Access Control Server of the issuer
     "mpi_timestamp": "YYYYMMDDHHMM",  // Authentication timestamp
     "cardholder_info": "Additional authentication is needed for this transaction, 
       contact (Issuer Name) at..", // Copy of the message customer received after authentication 
     "authentication_flow":"02" // Challenge flow indicator
    },
   "code": "0",
   "message": "Success",
   "eci": "07"
   },
   "signature": "v7KNMpfogAxwRIL9tVftZ1ZZ5D/aZAeb0VMdeR+CqGrNxYyilUwSm...=="
}