Update additional fee
Sets your own charge (a delivery fee, handling, or similar) on top of one of your standard escrows. Every escrow starts at additionalFee: 0.
The buyer is charged amount + their fee share + additionalFee at checkout, and the whole additionalFee is credited to your merchant wallet when the escrow completes, recorded as a delivery transaction so it stays separate from your commission. Payluk takes no cut of it, and it is not part of the escrow amount, so neither the seller’s payout nor the escrow fee changes.
When you can call this
Only while the escrow is still PENDING / AWAITING_PAYMENT. Once the buyer pays, the charge is frozen, because they have already been quoted and debited a total that includes it. It is a plain setter until then: call it as often as you need, and send 0 to remove a charge you set earlier.
Standard escrows only. Milestone and vault escrows are rejected.
Refunds
Who keeps the charge if a dispute is later resolved in the buyer’s favour is normally decided when you resolve that dispute: Resolve dispute takes additionalFeeRefundable with your ruling, since only then do you know whether the delivery happened.
Sending additionalFeeRefundable here just sets the default that applies if a dispute is resolved without an explicit choice: true (the default) returns the charge to the buyer, false credits it to you. Omit the field to leave the escrow’s current setting untouched.
Super-admin key required. Do not send the customer-id header.
Authorizations
Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (test) or sk_live_... (live).
Path Parameters
The escrow's payment token (e.g. PY_8AB12C9D3045).
Body
The charge to add on top of the escrow amount, as a whole number in NGN. Send 0 to remove a charge set earlier.
x >= 02500
The default for who keeps the charge if a dispute is resolved in the buyer's favour: true returns it to the buyer, false credits it to you. Usually left alone, since the decision is normally made when resolving the dispute, which overrides this. Omit to leave the escrow's current setting unchanged.
true