Skip to content

docs(rest-api): add deferred tokenization endpoint#176

Merged
ecunado merged 6 commits intodevfrom
API-23
Mar 17, 2026
Merged

docs(rest-api): add deferred tokenization endpoint#176
ecunado merged 6 commits intodevfrom
API-23

Conversation

@ecunado
Copy link
Contributor

@ecunado ecunado commented Mar 17, 2026

Summary

  • Documents the new GET /transactions/{guid}/token endpoint for deferred tokenization
  • Adds DeferredTokenizationResponse object to the REST API objects reference
  • Endpoint allows merchants to retrieve a card token from any previously completed card-present transaction (without needing to enable tokenization at transaction time)

Details

The deferred tokenization flow:

  1. A card-present is processed normally on the terminal
  2. At any point after completion, the merchant calls GET /transactions/{guid}/token with the transaction GUID
  3. The response includes a cardToken that can be used for subsequent MOTO operations

Eligible transaction types: sale, refund, preAuthorizationCapture, moToSale and moToRefund.
Non-eligible types (e.g. tip adjustments) return HTTP 400 / error code 3112.

Test plan

  • Verify the new endpoint section renders correctly in Docusaurus (yarn start)
  • Check the DeferredTokenizationResponse object appears alphabetically in the Objects page between "Device Status" and "Financial Status"
  • Verify the internal link from the endpoint to the object (restobjects.md#deferredTokenizationResponse) resolves correctly
  • Validate the curl examples match the format used in the rest of the endpoints doc

ecunado and others added 4 commits March 17, 2026 09:51
Documents the GET /transactions/{guid}/token endpoint that allows merchants
to retrieve a card token from a previously completed card-present transaction.
Adds DeferredTokenizationResponse object to the objects reference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add all eligible transaction types: sale, refund, preAuthorizationCapture,
moToSale and moToRefund.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ll supported types

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove redundant type list from prose (already in the note box) and
broaden cardToken use cases beyond MOTO operations.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ecunado and others added 2 commits March 17, 2026 12:34
…tokenization endpoint

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ecunado ecunado merged commit 9c06622 into dev Mar 17, 2026
2 checks passed
@ecunado ecunado deleted the API-23 branch March 17, 2026 11:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants