Capture Payment Instruction

May 27, 2025 ยท View on GitHub

Any additional payment instructions to be consider during payment processing. This processing instruction is applicable for Capturing an order or Authorizing an Order.

Structure

CapturePaymentInstruction

Fields

NameTypeTagsDescriptionGetterSetter
PlatformFeesList<PlatformFee>OptionalAn array of platform or partner fees, commissions, or brokerage fees that associated with the captured payment.

Constraints: Minimum Items: 0, Maximum Items: 1
List getPlatformFees()setPlatformFees(List platformFees)
DisbursementModeDisbursementModeOptionalThe funds that are held on behalf of the merchant.

Default: DisbursementMode.INSTANT

Constraints: Minimum Length: 1, Maximum Length: 16, Pattern: ^[A-Z_]+$
DisbursementMode getDisbursementMode()setDisbursementMode(DisbursementMode disbursementMode)
PayeeReceivableFxRateIdStringOptionalFX identifier generated returned by PayPal to be used for payment processing in order to honor FX rate (for eligible integrations) to be used when amount is settled/received into the payee account.

Constraints: Minimum Length: 1, Maximum Length: 4000, Pattern: ^.*$
String getPayeeReceivableFxRateId()setPayeeReceivableFxRateId(String payeeReceivableFxRateId)

Example (as JSON)

{
  "disbursement_mode": "INSTANT",
  "platform_fees": [
    {
      "amount": {
        "currency_code": "currency_code6",
        "value": "value0"
      },
      "payee": {
        "email_address": "email_address4",
        "merchant_id": "merchant_id6"
      }
    },
    {
      "amount": {
        "currency_code": "currency_code6",
        "value": "value0"
      },
      "payee": {
        "email_address": "email_address4",
        "merchant_id": "merchant_id6"
      }
    }
  ],
  "payee_receivable_fx_rate_id": "payee_receivable_fx_rate_id8"
}