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": {}
          }
        }
      ]
    }
}

• This structure can be retrieved via the Get a client session endpoint or the Get Payment endpoint.

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

Status	Description
AUTHORIZED	The partner transaction was successfully approved and completed.
PENDING	The partner transaction is still being processed.
ERROR	An error occurred during the partner transaction.
ABORTED	The partner transaction was terminated before completion.
REFUSED	The partner transaction was rejected, leading to an authorization failure.