Capture Truemed Session

Report a charge you captured on your own payment rail. Send a transaction_info block describing the charge; Truemed records it onto the session — for substantiation and session history — and computes its fee. The captured amount is derived from the session’s order items rather than trusted from the request, so there is no separate amount field.

Idempotent on the pair of sales channel and merchant_transaction_id: replaying the same merchant transaction returns the originally recorded result rather than double-recording the charge.

Report a charge you captured on your own payment rail. Send a `transaction_info` block describing the charge; Truemed records it onto the session — for substantiation and session history — and computes its fee. The captured amount is derived from the session's order items rather than trusted from the request, so there is no separate amount field. Idempotent on the pair of sales channel and `merchant_transaction_id`: replaying the same merchant transaction returns the originally recorded result rather than double-recording the charge.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Path parameters

truemed_session_idstringRequired

The Truemed session ID from the URL path.

Request

Request body for CaptureTruemedSessionV2Request

item_detailslist of objectsRequired

Itemized attribution for the captured amount: each entry captures part of a line item, up to its capturable quantity and total from the session detail. The captured amount is derived from these line totals, not a separate amount field.

idempotency_keystring or nullOptional1-200 characters

A unique key making the capture report safely retryable. Capture reports are also deduplicated by merchant_transaction_id.

merchant_transaction_idstring or nullOptional1-200 characters

Your processor’s identifier for the captured transaction. Deduplication key: reporting the same merchant_transaction_id again returns the original result. Required when reporting a capture.

transaction_infoobject or nullOptional

Settlement details for a capture your platform processed on its own rail. Required alongside merchant_transaction_id.

Response

Successful response

captured_amount_centsinteger

Cumulative captured amount on this session, in cents, including this capture.

truemed_session_idstring

The session the capture was executed against.

capture_idstring or null

Truemed’s stable ID for the recorded capture (mrt_<capture_id>).

Errors

400

Bad Request Error

404

Not Found Error

405

Method Not Allowed Error

500

Internal Server Error

501

Not Implemented Error

$	curl -X POST https://dev-api.truemed.com/api/v2/truemed_sessions/truemed_session_id/capture \
>	-H "x-truemed-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"item_details": [
>	{
>	"item_id": "line_item_1",
>	"quantity": 1,
>	"total": 11850,
>	"amount_details": {
>	"additional_charges_details": [
>	{
>	"amount_cents": 850,
>	"display_level": "tax",
>	"name": "Tax"
>	}
>	],
>	"discounts_details": [
>	{
>	"amount_cents": 1000,
>	"display_level": "line_item",
>	"name": "WELCOME10"
>	}
>	]
>	}
>	}
>	],
>	"merchant_transaction_id": "shop_pay_charge_1001",
>	"transaction_info": {
>	"capture_time": "2026-06-30T16:00:00Z",
>	"card_holder_name": "Alex Morgan",
>	"last4": "4242",
>	"merchant_descriptor": "MERCHANT SHOP",
>	"network": "visa",
>	"postal_code": "94105",
>	"network_transaction_id": "visa_txn_123456789"
>	}
>	}'

1	{
2	"captured_amount_cents": 11850,
3	"truemed_session_id": "ts_01JZ7D4M3A8B9C0D1E2F3G4H5J",
4	"capture_id": "mrt_9001"
5	}