worldline Direct
Sign up

In legacy, DirectQuery requests allow you to get information about a transaction's status in two ways:

  • Sending parameter PAYID only returns the global transaction status.
  • Adding optional parameter PAYIDSUB returns a specific (temporary) status in the transaction's life cycle. For each (temporary) status, legacy creates individual PAYIDSUBs according to an incremental logic.

Direct replaces the PAYID/PAYIDSUB logic in favour of property payment.id

Our platform returns a separate, unique payment.id for every CreatePayment request and every maintenance operation (i.e. CapturePayment/RefundPayment/CancelPayment) you perform on an existing transaction. Hence, follow this payment.id logic when following-up on transactions proactively via GetPaymentDetails or processing our platform's transaction feedback via webhooks.

  • Learn more about the payment.id logic in a dedicated chapter in our Webhooks guide.
  • For CreateHostedCheckout requests via integration method Hosted Checkout Page, our platform returns a hostedCheckoutId instead of a payment.id. To follow-up on Hosted Checkout Page sessions, send a GetHostedCheckoutSession requests which accepts this hostedCheckoutId.

Was this page helpful?

Do you have any comments?

Thank you for your response.
New Feature

Try out our new chatbot and find answers to all your questions.