Skip to main content

Partner Transaction

Definition

A Partner Transaction refers to a financial transaction initiated and processed by a Payment Service Provider (PSP) on behalf of a merchant or customer.
This includes transactions such as credit card payments, digital wallets, and other online payment methods.

Within Payment API V2, payments and operations (authorization, capture, void, refund) can be split across multiple partners.
As a result, each authorization, capture, void, or refund contains a set of partner transactions.

Example

Example of partner_transactions in a Client Session

{
[...]
"authorization":
{
"status": "AUTHORIZED",
"partner_transactions": [
{
"partner": "dalenys",
"method": "creditcard",
"id": "f37a4096-a961-45a5-8e04-94625cbf7c43",
"amount": 11175,
"remaining_amount": 11175,
"partner_reference": "A161236020",
"partner_status": "0000",
"partner_status_description": "Successful operation",
"status": "AUTHORIZED",
"card": {
"bin": "411111",
"last_four_digits": "1111",
"holder_name": "Théodore Roosevelt",
"expiry_month": "01",
"expiry_year": "2029",
"selected_network": "VISA",
"three_ds": {}
}
}
]
}
}

Partner Transaction Status

In the example ahead, you can see two statuses related to the partner transaction:

  1. partner_status → Directly returned by the PSP.
  2. status → Managed by the Payment API V2, ensuring consistency.
warning

Merchants should rely on the status from our API, rather than the partner_status from the PSP.
This ensures a standardized approach to transaction handling across different PSPs.

Standardized Partner Transaction Statuses

StatusDescription
AUTHORIZEDThe partner transaction was successfully approved and completed.
PENDINGThe partner transaction is still being processed.
ERRORAn error occurred during the partner transaction.
ABORTEDThe partner transaction was terminated before completion.
REFUSEDThe partner transaction was rejected, leading to an authorization failure.