Create PayoutAsk AIpost https://api-sandbox.payretailers.com/payments/v2/payoutUse this call to create a payout and send money to your customers.Body ParamsBeneficiaryFirstNamestringrequiredThe customer's first name.Data validation: [A-Z] Length : AR, BR: 255 | CL, MX, CO, EC, PE: 32BeneficiaryLastNamestringrequiredThe customer's last name.Data validation: [A-Z] Length : AR, BR: 255 | CL, MX, CO, EC, PE: 32DocumentTypestringrequiredThe type of document used to identify the customerLength : AR: 1 | BR: 1 | CL: 6 | MX, CO, EC, PE: 2Value per country: AR | BR | CL | MX | CO | EC | PEPayoutBeneficiaryTypeCodestringCL Only. Required.Used to define if your customer is a physical person or a company.Values: person | companyDocumentNumberstringrequiredThe personal ID of the customer.Data validation: [A-Z][0-9]Length : AR: 8 | BR: 11 | CL: 9 | MX: 18 | CO: 6-10 | EC: 10 | PE: 9EmailstringrequiredThe customer's email address.Data validation: [A-Z][0-9][-&_]@[A-Z][0-9].[A-Z]Length: 255PhonestringRequired in BR, PE and AFRICA. Optional in AR, CL & MX. Do not include for CO.The customer's phone number. Can include special characters like +().Data validation: [0-9][()+]Length : AR, BR, CL, MX: 13 | PE: 9-11GenderstringAR BR CL MX Only. Optional.The gender of the customer.Data validation: *Length: 20CountrystringrequiredThe country code of the payout. Length: 2Values: AR | BR | CL | CO | EC | MX | PECitystringDo not include for CO.The city of the customer.Data validation: *Length: 150AddressstringDo not include for CO.The billing address of the customer.Data validation: *Length : AR, BR: 255 | CL, MX, EC, PE: 70CurrencyCodestringrequiredThe currency code of the currency used for the payout.Length: 3Values: AR: ARS | BR: BRL | CL: CLP | CO: COP | EC: USD | MX: MXN | PE: PEN | ALL: USDAmountfloatrequiredThe amount of the payoutData validation: [0-9]Length : AR, BR, CL, MX: 18,2 | CO, EC, PE: 11,2NotificationUrlstringThe URL used to send notifications when a payout is created and changes status.Data validation: [0-9] [a-z] [(-), (_), (.), (~)]Length: 255PayoutChannelstringrequiredChannel through which the payout will be processed.ONLINE for traditional bank transfers. PIX included for BR.Values: ONLINERecipientPixKeystringBR Only. Optional.The PIX key of the customer. Include if the payout must be done via PIX payout.Data validation: [A-Z][-][0-9]Length: MAXValue: Recipient Pix KeyAccountNumberstringrequiredThe account number of the customer.Data validation: [0-9]Length : AR: 22 | BR: 13 | CL: See special requirements | CO: 16 | MX: 16 or 18 (See special requirements) | EC: 12 | PE: see special requirementsSome countries have special requirements: AR | PE | MX | CLAccountAgencyNumberstringBR Only. Required.The agency code of the bank provided by the bank.Length: 6Value: Account Agency NumberPayoutAccountTypeCodestringrequiredA code that identifies the type of account used by the user.Length : AR: 1 | BR, CL, MX, CO, EC, PE: 4Value per country: AR | BR | CL | MX | CO | EC | PEBankNamestringrequiredThe code that identified the bank used by the customer.Length : AR: 1 | BR, CL: 3 | MX: 5 | CO, EC, PE: 4 Value per country: AR | BR | CL | MX | CO | EC | PEAbaSwiftstringBR only. Optional.The swift number of the bank used by the customer.Data validation: [A-Z][0-9]Length: 50ExternalReferencestringrequiredOptional external reference that can be used to track the payout.Data validation: *Length: 255PaymentReasonstringA reason for the payment.Data validation: *Length : AR, BR, CL, CO, EC, PE: MAX | MX: 40TestModebooleanDefaults to falseUsed to make the difference between real payouts and test payouts. Check the Test Mode page for more details.truefalseTestModeCallBackStatusstringThe status that you want to receive in your callback when testing your payout. Check the Test Mode page for more details.TermsApprovedbooleanDefaults to trueRequired only for payouts in USDtruefalsePayoutQuoteIdstringUnique payout quote ID returned from the Payout Quote end point, locking the FX rate, fee and values to those specified in the quote. Time limit from receiving Payout Quote to submitting Payout referencing Quote ID is 5 minutes.HeadersOcp-Apim-Subscription-KeystringrequiredThe subscription key has a length of 32 characters and will be provided within the API keys. Will be available for new integrations from July 24th onwards.acceptstringenumDefaults to application/jsonGenerated from available response content typesapplication/jsontext/plainAllowed:application/jsontext/plainResponses 200200 401401 403403Updated 10 months ago