Transaction: Submit For Partial Settlement

PHPSDK

• Current Braintree Languages
• Java
• .NET
• Node.js
• PHP
• Python
• Ruby

1. Authorize the entire order amount using Transaction: Sale.
   • Do not pass the submitForSettlement option or make a submitForSettlement call.
2. Make a separate submitForPartialSettlement call for each portion you want to settle separately.
   • For each call, specify the authorized-transaction and the amount to settle.

$result = $gateway->transaction()->submitForPartialSettlement('theParentAuthTransactionId', '10.00', [
    'orderId' => 'orderId'
]);

if ($result->success) {
    $settledTransaction = $result->transaction;
} else {
    print_r($result->errors);
}

Arguments

Additional Parameters

Transaction settlement

• Each partial settlement will create a new child transaction in the gateway with the same details as the original transaction, but with the amount specified in the submitForPartialSettlement call.
• Once the child transaction is created, the parent will move to a status, whereas the child will move from > > .
• The parent transaction will move from to when any of the following is true:
  • All child transactions are and the cumulative amount submitted for settlement across all child transactions is equal to the amount authorized on the parent transaction.
  • The original authorization is and there are one or more child transactions associated with the parent transaction.
  • The parent transaction has remained in for longer than 30 days, regardless of the child transactions' status.
• Once the parent moves to the status, no further settlements can be created on that transaction.

Refunds

• Once you've submitted a transaction for partial settlement, you can only issue a refund against the child transaction(s).
• A refund on a child transaction can be up to the amount settled on the child.
• A refund can be issued only when the corresponding transaction has fully settled and is in a state.

Control Panel visibility

• The parent and child transactions will appear linked in the Control Panel as Authorized Transaction and Settlement Transaction ID, respectively.
• The parent transaction will show the child transaction(s) under the Settlement Information section on the transaction search in the Control Panel. Similarly, the child transactions will show the parent for authorization information.

See Also

• Transaction - Sale
• Transaction - Refund
• Transaction - Void