From a247ec798249c82862b851375489a29171ae135f Mon Sep 17 00:00:00 2001 From: Pavlo Iusim Date: Wed, 7 Jan 2026 23:14:18 -0500 Subject: [PATCH 1/4] DOCS-1322 Adding details on Orchestration transactions to Reports docs --- changelog.mdx | 20 ++++++++++++++++ snippets/reports-resource-transfer-type.mdx | 26 +++++++++++---------- snippets/reports-resources.mdx | 17 +++++++------- 3 files changed, 43 insertions(+), 20 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index 135ca00e..c65572e0 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -3,6 +3,26 @@ title: "Changelog" description: "Product updates and announcements" rss: true --- + +## Upcoming Changes + + +**Profile Transaction Reconciliation Reports**: Paxos is enhancing reconciliation reports with the following changes: + +- **Stablecoin Conversion API transactions** will use new identifiers: + - Resource: `SWAP` (replacing `CONVERSION`) + - Transaction Type: `SWAP_TX` (replacing `CONVERSION_CREATION` and `CONVERSION_SETTLEMENT`) + - `OrchestrationID` field will link related conversion legs + +- **Orchestration API transactions** will be represented with new fields: + - New Resource Type: `ORCHESTRATION` + - New Resource Transfer Types: `ORCHESTRATION_RESERVE` and `ORCHESTRATION_UNRESERVE` reserving funds during an orchestration flow + +These changes will improve tracking of multi-step transactions and provide better visibility into fund allocation during processing. + + +--- + **v2 API**: Add value `AIPRISE` to parameter `person_details.passthrough_verifier_type` on Create Identity and Update Identity request and response for passthrough person IDV. diff --git a/snippets/reports-resource-transfer-type.mdx b/snippets/reports-resource-transfer-type.mdx index 13f7f973..9be92db3 100644 --- a/snippets/reports-resource-transfer-type.mdx +++ b/snippets/reports-resource-transfer-type.mdx @@ -1,14 +1,16 @@ The ResourceTransferType identifies the direction of each transfer and whether it was a movement of fiat into or out of the Paxos Platform (WIRE\_, SEN\_), a movement of crypto asset into or out of Paxos (CRYPTO\_), or a movement of crypto or fiat between profiles within the Paxos platform (PROFILE_TRANSFER). -| Resource | TransferType | Description | -| --- | --- | --- | -| TRANSFER | CRYPTO_DEPOSIT | A crypto deposit into Paxos. | -| TRANSFER | CRYPTO_WITHDRAWAL | A crypto withdrawal out of Paxos. | -| TRANSFER | INTERNAL_TRANSFER_CREDIT | Transfer received from another Profile. | -| TRANSFER | INTERNAL_TRANSFER_DEBIT | Transfer sent to another Profile. | -| TRANSFER | PAXOS_TRANSFER_CREDIT | Transfer received from another Peer. | -| TRANSFER | PAXOS_TRANSFER_DEBIT | Transfer sent to another Peer. | -| TRANSFER | SEN_DEPOSIT | Deprecated. Does not appear in new reports. A deposit into Paxos platform on the Silvergate Exchange Network. | -| TRANSFER | SEN_WITHDRAWAL | Deprecated. Does not appear in new reports. A withdrawal out of Paxos on the Silvergate Exchange Network . | -| TRANSFER | WIRE_DEPOSIT | A wire deposit into Paxos. | -| TRANSFER | WIRE_WITHDRAWAL | A wire withdrawal out of Paxos. | \ No newline at end of file +| Resource | TransferType | Description | +|----------|--------------------------|---------------------------------------------------------------------------------------------------------------| +| TRANSFER | CRYPTO_DEPOSIT | A crypto deposit into Paxos. | +| TRANSFER | CRYPTO_WITHDRAWAL | A crypto withdrawal out of Paxos. | +| TRANSFER | INTERNAL_TRANSFER_CREDIT | Transfer received from another Profile. | +| TRANSFER | INTERNAL_TRANSFER_DEBIT | Transfer sent to another Profile. | +| TRANSFER | ORCHESTRATION_RESERVE | Assets reserved for Orchestration processing | +| TRANSFER | ORCHESTRATION_UNRESERVE | Assets unreserved after Orchestration processing | +| TRANSFER | PAXOS_TRANSFER_CREDIT | Transfer received from another Peer. | +| TRANSFER | PAXOS_TRANSFER_DEBIT | Transfer sent to another Peer. | +| TRANSFER | SEN_DEPOSIT | Deprecated. Does not appear in new reports. A deposit into Paxos platform on the Silvergate Exchange Network. | +| TRANSFER | SEN_WITHDRAWAL | Deprecated. Does not appear in new reports. A withdrawal out of Paxos on the Silvergate Exchange Network . | +| TRANSFER | WIRE_DEPOSIT | A wire deposit into Paxos. | +| TRANSFER | WIRE_WITHDRAWAL | A wire withdrawal out of Paxos. | \ No newline at end of file diff --git a/snippets/reports-resources.mdx b/snippets/reports-resources.mdx index 8c523cb0..3178a2f3 100644 --- a/snippets/reports-resources.mdx +++ b/snippets/reports-resources.mdx @@ -1,10 +1,11 @@ The Resource field denotes the category of transaction being recorded on each row of the [Profile Transactions Report](#ProfileTransactionReport). -| Resource Enum Value | Description | -| --- | --- | -| CONVERSION | Stablecoin conversion transaction. | -| EXECUTION | An execution of an order on the order book. There can be multiple executions for one order. | -| ORDER | A market or limit order placed for trading. Using either FIX or the v2 Order service. | -| QUOTE_EXECUTION | A Held Rate Quote transaction. | -| TRANSFER | A transfer on or off the Paxos platform. For example, a wire withdrawal or crypto deposit. | -| WIRE_WITHDRAWAL_UPLOAD | A manually created wire withdrawal. | \ No newline at end of file +| Resource Enum Value | Description | +|------------------------|---------------------------------------------------------------------------------------------| +| CONVERSION | Stablecoin conversion transaction. | +| EXECUTION | An execution of an order on the order book. There can be multiple executions for one order. | +| ORCHESTRATION | A multi-step workflow to move between assets, networks, and rails. | +| ORDER | A market or limit order placed for trading. Using either FIX or the v2 Order service. | +| QUOTE_EXECUTION | A Held Rate Quote transaction. | +| TRANSFER | A transfer on or off the Paxos platform. For example, a wire withdrawal or crypto deposit. | +| WIRE_WITHDRAWAL_UPLOAD | A manually created wire withdrawal. | \ No newline at end of file From faa690d8f0d73b8eadff6a3c2719b7c33a84ca21 Mon Sep 17 00:00:00 2001 From: Pavlo Iusim Date: Wed, 7 Jan 2026 23:40:13 -0500 Subject: [PATCH 2/4] typo --- changelog.mdx | 2 +- snippets/reports-resource-transfer-type.mdx | 2 - snippets/reports-transaction-type.mdx | 49 +++++++++++---------- 3 files changed, 27 insertions(+), 26 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index c65572e0..cfd25216 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -16,7 +16,7 @@ rss: true - **Orchestration API transactions** will be represented with new fields: - New Resource Type: `ORCHESTRATION` - - New Resource Transfer Types: `ORCHESTRATION_RESERVE` and `ORCHESTRATION_UNRESERVE` reserving funds during an orchestration flow + - New Resource Transaction Types: `ORCHESTRATION_RESERVE` and `ORCHESTRATION_UNRESERVE` reserving funds during an orchestration flow These changes will improve tracking of multi-step transactions and provide better visibility into fund allocation during processing. diff --git a/snippets/reports-resource-transfer-type.mdx b/snippets/reports-resource-transfer-type.mdx index 9be92db3..7fea055b 100644 --- a/snippets/reports-resource-transfer-type.mdx +++ b/snippets/reports-resource-transfer-type.mdx @@ -6,8 +6,6 @@ The ResourceTransferType identifies the direction of each transfer and whether i | TRANSFER | CRYPTO_WITHDRAWAL | A crypto withdrawal out of Paxos. | | TRANSFER | INTERNAL_TRANSFER_CREDIT | Transfer received from another Profile. | | TRANSFER | INTERNAL_TRANSFER_DEBIT | Transfer sent to another Profile. | -| TRANSFER | ORCHESTRATION_RESERVE | Assets reserved for Orchestration processing | -| TRANSFER | ORCHESTRATION_UNRESERVE | Assets unreserved after Orchestration processing | | TRANSFER | PAXOS_TRANSFER_CREDIT | Transfer received from another Peer. | | TRANSFER | PAXOS_TRANSFER_DEBIT | Transfer sent to another Peer. | | TRANSFER | SEN_DEPOSIT | Deprecated. Does not appear in new reports. A deposit into Paxos platform on the Silvergate Exchange Network. | diff --git a/snippets/reports-transaction-type.mdx b/snippets/reports-transaction-type.mdx index 9dcf8be0..4d9c6472 100644 --- a/snippets/reports-transaction-type.mdx +++ b/snippets/reports-transaction-type.mdx @@ -1,26 +1,29 @@ The values of the TransactionType vary depending on the Resource. The TransactionType denotes the specific purpose of the transaction. -| Resource | TransactionType | Description | -| --- | --- | --- | -| CONVERSION | CONVERSION_CANCELLATION | A transaction to unreserve funds for a created stablecoin conversion. | -| CONVERSION | CONVERSION_CREATION | A transaction to reserve funds for a stablecoin conversion. | -| CONVERSION | CONVERSION_SETTLEMENT | Settlement of the stablecoin conversion transaction. | -| EXECUTION | COMMISSION | A transaction to collect commission from an executed trade. | -| EXECUTION | SETTLE_BASE | Settlement of the base (crypto) side of the trade to/from the counterparty. | -| EXECUTION | SETTLE_QUOTE | Settlement of the quote (cash) side of the trade to/from the counterparty For example, a SELL order has been executed. | -| EXECUTION | SETTLE_UNRESERVE | A transaction to unreserve funds for trading because of a BUY side price improvement on an executed order. For example, a limit order used a BUY price of $50,000 but executed at $49,000). | -| ORDER | RESERVE | A transaction to reserve funds for trading. For example, a limit order has been placed. | -| ORDER | UNRESERVE | A transaction to unreserve funds for trading. For example, a limit order has been canceled. | -| QUOTE_EXECUTION | COLLECT_FROM_EXECUTOR | A record of transaction indicating a credit of the account. | -| QUOTE_EXECUTION | FUND_EXECUTOR | A record of transaction indicating a debit of the account. | -| TRANSFER | DEPOSIT_COMPLETION | A transaction to complete a deposit, resulting in funds being credited. | -| TRANSFER | DEPOSIT_CREATION | A transaction to deposit funds into the Paxos platform. | -| TRANSFER | DEPOSIT_FAILURE | A transaction to reserve the funds of a failed deposit into pending debit where they can move off the Paxos platform back to their source. | -| TRANSFER | FEE_DEBIT | A transaction to debit the fees upon completion of the transfer. | -| TRANSFER | FEE_ENCUMBERMENT | A transaction to reserve the transfer fee. | -| TRANSFER | INTERNAL_TRANSFER | A book transfer of funds to another profile under the same customer account. | -| TRANSFER | PAXOS_TRANSFER | A book transfer of funds to another Paxos customer. | -| TRANSFER | WITHDRAWAL_COMPLETION | A transaction to complete a withdrawal, resulting in the transfer of funds off the Paxos platform. | -| TRANSFER | WITHDRAWAL_CREATION | A transaction to initiate a withdrawal typically reserving the debit amount. For example, a wire withdrawal or crypto withdrawal. | -| TRANSFER | WITHDRAWAL_FAILURE | A transaction to return funds previously reserved for a failed withdrawal. | +| Resource | TransactionType | Description | +|-----------------|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| CONVERSION | CONVERSION_CANCELLATION | A transaction to unreserve funds for a created stablecoin conversion. | +| CONVERSION | CONVERSION_CREATION | A transaction to reserve funds for a stablecoin conversion. | +| CONVERSION | CONVERSION_SETTLEMENT | Settlement of the stablecoin conversion transaction. | +| EXECUTION | COMMISSION | A transaction to collect commission from an executed trade. | +| EXECUTION | SETTLE_BASE | Settlement of the base (crypto) side of the trade to/from the counterparty. | +| EXECUTION | SETTLE_QUOTE | Settlement of the quote (cash) side of the trade to/from the counterparty For example, a SELL order has been executed. | +| EXECUTION | SETTLE_UNRESERVE | A transaction to unreserve funds for trading because of a BUY side price improvement on an executed order. For example, a limit order used a BUY price of 90,000 but executed at 89,000). | +| ORCHESTRATION | ORCHESTRATION_RESERVE | A transaction to reserve funds for Orchestration processing | +| ORCHESTRATION | ORCHESTRATION_UNRESERVE | A transaction to unreserve funds after Orchestration processing | +| ORDER | RESERVE | A transaction to reserve funds for trading. For example, a limit order has been placed. | +| ORDER | UNRESERVE | A transaction to unreserve funds for trading. For example, a limit order has been canceled. | +| QUOTE_EXECUTION | COLLECT_FROM_EXECUTOR | A record of transaction indicating a credit of the account. | +| QUOTE_EXECUTION | FUND_EXECUTOR | A record of transaction indicating a debit of the account. | +| TRANSFER | DEPOSIT_COMPLETION | A transaction to complete a deposit, resulting in funds being credited. | +| TRANSFER | DEPOSIT_CREATION | A transaction to deposit funds into the Paxos platform. | +| TRANSFER | DEPOSIT_FAILURE | A transaction to reserve the funds of a failed deposit into pending debit where they can move off the Paxos platform back to their source. | +| TRANSFER | FEE_DEBIT | A transaction to debit the fees upon completion of the transfer. | +| TRANSFER | FEE_ENCUMBERMENT | A transaction to reserve the transfer fee. | +| TRANSFER | INTERNAL_TRANSFER | A book transfer of funds to another profile under the same customer account. | +| TRANSFER | PAXOS_TRANSFER | A book transfer of funds to another Paxos customer. | +| TRANSFER | WITHDRAWAL_COMPLETION | A transaction to complete a withdrawal, resulting in the transfer of funds off the Paxos platform. | +| TRANSFER | WITHDRAWAL_CREATION | A transaction to initiate a withdrawal typically reserving the debit amount. For example, a wire withdrawal or crypto withdrawal. | +| TRANSFER | WITHDRAWAL_FAILURE | A transaction to return funds previously reserved for a failed withdrawal. | + From 03365d1cdce2de39e3e5f433e5e5bd4a64f3f034 Mon Sep 17 00:00:00 2001 From: Pavlo Iusim Date: Thu, 8 Jan 2026 12:38:12 -0500 Subject: [PATCH 3/4] wording --- changelog.mdx | 20 -------------------- snippets/reports-transaction-type.mdx | 4 ++-- 2 files changed, 2 insertions(+), 22 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index cfd25216..135ca00e 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -3,26 +3,6 @@ title: "Changelog" description: "Product updates and announcements" rss: true --- - -## Upcoming Changes - - -**Profile Transaction Reconciliation Reports**: Paxos is enhancing reconciliation reports with the following changes: - -- **Stablecoin Conversion API transactions** will use new identifiers: - - Resource: `SWAP` (replacing `CONVERSION`) - - Transaction Type: `SWAP_TX` (replacing `CONVERSION_CREATION` and `CONVERSION_SETTLEMENT`) - - `OrchestrationID` field will link related conversion legs - -- **Orchestration API transactions** will be represented with new fields: - - New Resource Type: `ORCHESTRATION` - - New Resource Transaction Types: `ORCHESTRATION_RESERVE` and `ORCHESTRATION_UNRESERVE` reserving funds during an orchestration flow - -These changes will improve tracking of multi-step transactions and provide better visibility into fund allocation during processing. - - ---- - **v2 API**: Add value `AIPRISE` to parameter `person_details.passthrough_verifier_type` on Create Identity and Update Identity request and response for passthrough person IDV. diff --git a/snippets/reports-transaction-type.mdx b/snippets/reports-transaction-type.mdx index 4d9c6472..8d7a8940 100644 --- a/snippets/reports-transaction-type.mdx +++ b/snippets/reports-transaction-type.mdx @@ -10,8 +10,8 @@ The TransactionType denotes the specific purpose of the transaction. | EXECUTION | SETTLE_BASE | Settlement of the base (crypto) side of the trade to/from the counterparty. | | EXECUTION | SETTLE_QUOTE | Settlement of the quote (cash) side of the trade to/from the counterparty For example, a SELL order has been executed. | | EXECUTION | SETTLE_UNRESERVE | A transaction to unreserve funds for trading because of a BUY side price improvement on an executed order. For example, a limit order used a BUY price of 90,000 but executed at 89,000). | -| ORCHESTRATION | ORCHESTRATION_RESERVE | A transaction to reserve funds for Orchestration processing | -| ORCHESTRATION | ORCHESTRATION_UNRESERVE | A transaction to unreserve funds after Orchestration processing | +| ORCHESTRATION | ORCHESTRATION_RESERVE | A transaction to reserve funds for Orchestration processing. | +| ORCHESTRATION | ORCHESTRATION_UNRESERVE | A transaction to unreserve funds in case Orchestration failure. | | ORDER | RESERVE | A transaction to reserve funds for trading. For example, a limit order has been placed. | | ORDER | UNRESERVE | A transaction to unreserve funds for trading. For example, a limit order has been canceled. | | QUOTE_EXECUTION | COLLECT_FROM_EXECUTOR | A record of transaction indicating a credit of the account. | From 10608f6a71f490464471aa5f448411939b3716d4 Mon Sep 17 00:00:00 2001 From: Pavlo Iusim <92478851+pavloiusim@users.noreply.github.com> Date: Thu, 8 Jan 2026 13:23:18 -0500 Subject: [PATCH 4/4] Update snippets/reports-transaction-type.mdx Co-authored-by: Jozsef Racz --- snippets/reports-transaction-type.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snippets/reports-transaction-type.mdx b/snippets/reports-transaction-type.mdx index 8d7a8940..a71a74ac 100644 --- a/snippets/reports-transaction-type.mdx +++ b/snippets/reports-transaction-type.mdx @@ -11,7 +11,7 @@ The TransactionType denotes the specific purpose of the transaction. | EXECUTION | SETTLE_QUOTE | Settlement of the quote (cash) side of the trade to/from the counterparty For example, a SELL order has been executed. | | EXECUTION | SETTLE_UNRESERVE | A transaction to unreserve funds for trading because of a BUY side price improvement on an executed order. For example, a limit order used a BUY price of 90,000 but executed at 89,000). | | ORCHESTRATION | ORCHESTRATION_RESERVE | A transaction to reserve funds for Orchestration processing. | -| ORCHESTRATION | ORCHESTRATION_UNRESERVE | A transaction to unreserve funds in case Orchestration failure. | +| ORCHESTRATION | ORCHESTRATION_UNRESERVE | A transaction to unreserve funds in case of Orchestration failure. | | ORDER | RESERVE | A transaction to reserve funds for trading. For example, a limit order has been placed. | | ORDER | UNRESERVE | A transaction to unreserve funds for trading. For example, a limit order has been canceled. | | QUOTE_EXECUTION | COLLECT_FROM_EXECUTOR | A record of transaction indicating a credit of the account. |