Complete transaction

Changed on Nov 3, 2026

Attempts to complete or advance a pending 3DS 2 transaction. We require merchants to make authenticated calls to this endpoint in response to certain Spreedly.ThreeDS.Lifecycle events being emitted:

A pending transaction with a required_action of device_fingerprint will fire a trigger-completion event when the transaction status was updated due to a callback in the cardholder's iFrame or when 10 seconds have elapsed. When this event is received, it is necessary to call complete so that the latest transaction state can be retrieved in case of a timeout.

A pending transaction with a required_action of challenge will fire a finalization-timeout when our Spreedly.ThreeDS.Lifecycle stops polling for updates after 10-15 minutes of not receiving a new status. When this event is received, it is recommended that merchants call complete so that the transaction state can be updated due to cardholder abandonment or missed callbacks.

Please see our 3DS2 guides for more information and reference implementations.

post/transactions/{transaction_token}/complete

Request

Base URL
https://core.spreedly.com/v1
Auth
HTTP basic
TypeScript
https://skmtc.dev/spreedly/apis/spreedly-api-v1/docs/transactions/:transaction_token/complete/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

transaction_tokenstring required

The token of the transaction to complete

Response

Successful

Changes

Nov 3, 2026a33f10acbf55 Revision changes
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////////// to the response with the status (media type: application/json)
- info
  added the optional property ////////// to the response with the status (media type: application/xml)
- info
  added the optional property ////// to the response with the status (media type: application/json)
- info
  added the optional property ////// to the response with the status (media type: application/xml)
- info
  added the optional property ////// to the response with the status (media type: application/json)
- info
  added the optional property ////// to the response with the status (media type: application/xml)
- info
  added the optional property ////// to the response with the status (media type: application/json)
- info
  added the optional property ////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property /////// to the response with the status (media type: application/json)
- info
  added the optional property /////// to the response with the status (media type: application/xml)
- info
  added the optional property ////// to the response with the status (media type: application/json)
- info
  added the optional property ////// to the response with the status (media type: application/xml)

Operation history

Complete transaction

Request

Path parameters

Response 200OK

Changes

Response