action velopayments_submit_payout_v3 { label: "Submit Payout" description: "
Create a new payout and return a location header with a link to the payout
\nBasic validation of the payout is performed before returning but more comprehensive validation is done asynchronously
\nThe results can be obtained by issuing a HTTP GET to the URL returned in the location header
\n**NOTE:** amount values in payments must be in 'minor units' format. E.g. cents for USD, pence for GBP etc with no decimal places
\n" provider: velopayments method: POST path: "/v3/payouts" encoding: json input: { type: "object" required: ["payments"] properties: { payments: { type: "array" items: { type: "object" description: "Instruction for creating a payment" required: ["amount", "currency", "remoteId", "sourceAccountName"] properties: { amount: { type: "integer" format: "int64" description: "Amount to send to Payee
\nThe maximum payment amount is dependent on the currency
\n" } currency: { type: "string" description: "Valid ISO 4217 3 letter currency code. See the ISO specification for details." } paymentMemo: { type: "string" description: "Any value here will override the memo value in the parent payout
\nThis should be the reference field on the statement seen by the payee (but not via ACH)
\n" } paymentMetadata: { type: "string" description: "Metadata about the payment that may be relevant to the specific rails or remote system making the payout
\nThe structure of the data will be dictated by the requirements of the payment rails
\n" } payorPaymentId: { type: "string" description: "A reference identifier for the payor for the given payee payment" } remoteId: { type: "string" description: "Your identifier for the payee" } remoteSystemId: { type: "string" description: "The identifier for the remote payments system if not Velo
\nShould only be used after consultation with Velo Payments
\n" } sourceAccountName: { type: "string" description: "Must match a valid source account name belonging to the payor" } transmissionType: { type: "string" description: "Optionally choose a specific transmission method for the payment" enum: ["SAME_DAY_ACH", "WIRE", "ACH", "LOCAL", "SWIFT"] } } } } payoutFromPayorId: { type: "string" format: "uuid" description: "The id of the payor whose source account(s) will be debited
\npayoutFromPayorId and payoutToPayorId must be both supplied or both omitted
\n" } payoutMemo: { type: "string" description: "Text applied to all payment memos unless specified explicitly on a payment
\nThis should be the reference field on the statement seen by the payee (but not via ACH)
\n" } payoutToPayorId: { type: "string" format: "uuid" description: "The id of the payor whose payees will be paid
\npayoutFromPayorId and payoutToPayorId must be both supplied or both omitted
\n" } } } output: { type: "object" additionalProperties: true } }