TrusteePay: Checking Payment Status

Once a payment request (invoice) has been created via trusteePayStartRequest, you can check its status using trusteePayCheckRequest.

This allows you to track whether the user completed the payment, whether it is pending, or failed.

Check by Transaction ID or Response Key

You can check status by providing one or both of:

• merchantTransactionIds — your internal order or invoice IDs
• uniqueKeyForResponses — keys returned by trusteePayStartRequest

mutation trusteePayCheckRequest(
  $merchantWebKey: String!,
  $merchantTransactionIds: [String!],
  $uniqueKeyForResponses: [String]
) {
  trusteePayCheckRequest(
    merchantWebKey: $merchantWebKey,
    merchantTransactionIds: $merchantTransactionIds,
    uniqueKeyForResponses: $uniqueKeyForResponses
  )
}

🕒 No payment means the user didn’t confirm yet, or the invoice expired.

Polling Strategy

You can poll trusteePayCheckRequest periodically (e.g. every 5–10 seconds) after invoice creation. Or implement a webhook by contacting the developers team for real-time status updates.