Sign in

v1

latestOpenAPI 3.1.02026-07-26290133.2 KB

Create Customer Payout

post/transactions/customerPayout

Headers

idempotency-keystring

Optional header for retrying requests without accidentally creating the same transaction twice.

Request body

externalCustomerIdstring required

Unique ID of the customer on your system.

paymentTypestring

Type of payment that the beneficiary will receive.<br>SEPA or SEPA_INSTANT for EUR

referencestring required

Transaction reference to be sent to the beneficiary bank. The reference will appear on the beneficiary bank statement.

reasonCodestring

Payout Reason Code if required for the selected paymentType

metadataobject

Set of key-value pairs that you can attach to the Object. Useful for storing additional, structured information on the Object. e.g your internal ID of your user etc.<br> e.g `"userId":"ABC1234, "userName":"Boris Johnson"

purposeCode'ACCT' | 'ADCS' | 'AGRT' | 'ALMY' | 'AREN' | 'BENE' | 'BECH' | 'BKFE' | 'BKIP' | 'BKPP' | 'BLDM' | 'BONU' | 'BOCE' | 'BEXP' | 'BNET' | 'CBTV' | 'CBLK' | 'CASH' | 'CHAR' | 'CDBL' | 'CLPR' | 'CMDT' | 'COLL' | 'COMM' | 'COMP' | 'COMC' | 'COMT' | 'CORT' | 'CPYR' | 'CSDB' | 'DEPT' | 'DERI' | 'DBTC' | 'DIVD' | 'DNTS' | 'EDUC' | 'ELEC' | 'EPAY' | 'ESTX' | 'ECPR' | 'EXTD' | 'FEES' | 'FORW' | 'FREX' | 'FAND' | 'FUTR' | 'FNET' | 'FXNT' | 'GAMB' | 'GASB' | 'GDSV' | 'GIFT' | 'GOVT' | 'GSCB' | 'HEDG' | 'HLRP' | 'HLST' | 'HLTI' | 'HREC' | 'HSTX' | 'INPC' | 'INPR' | 'INSC' | 'INSU' | 'INSM' | 'INTE' | 'INTC' | 'INTP' | 'INVS' | 'INTX' | 'IVPT' | 'LICF' | 'LBRI' | 'LIFI' | 'LIMA' | 'LOAN' | 'LOAR' | 'LOTT' | 'LREB' | 'LREV' | 'LTCF' | 'MDCS' | 'NETT' | 'OTCD' | 'PEFC' | 'PENO' | 'PDEP' | 'PENS' | 'PCOM' | 'PHON' | 'PLDS' | 'PLRF' | 'PPTI' | 'PTXP' | 'REFU' | 'RELG' | 'RENT' | 'REOD' | 'REPO' | 'ROYA' | 'RDTX' | 'SALA' | 'SBSC' | 'SECU' | 'SERV' | 'SAVG' | 'SLEB' | 'SSBE' | 'SUBS' | 'SUPP' | 'SWFP' | 'SWUF' | 'TAXR' | 'TAXS' | 'TCSC' | 'TREA' | 'TRAD' | 'TRFD' | 'UBIL' | 'VATX' | 'VIEW' | 'WHLD' | 'WTER' | 'REBT' | 'SWPP' | 'SWRS'

Applicable for SWIFT and CHAPS GBP payments. See Supported Purpose Codes

Response

200

transactionIdstring
shortIdstring
{"stackTrail":"paths:/transactions/customerPayout:post:responses:200:content:application/json:schema:properties:externalCustomerId","oasType":"schema","type":"unknown"}
referencestring
paymentTypestring
reasonCodestring
{"stackTrail":"paths:/transactions/customerPayout:post:responses:200:content:application/json:schema:properties:bulkPaymentId","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/transactions/customerPayout:post:responses:200:content:application/json:schema:properties:metadata","oasType":"schema","type":"unknown"}
statusstring
transferTransactionIdstring
transferShortIdstring
endToEndReferencestring

Example response

{
  "transactionId": "591a8712-04f2-4518-9df3-8f81bec1819d",
  "shortId": "20220922-K3QY64",
  "reference": "payment to sweep",
  "paymentType": "SEPA_INSTANT",
  "reasonCode": "PERSONAL",
  "amount": {
    "value": 79,
    "currency": "EUR"
  },
  "beneficiary": {
    "customerType": "CORPORATE",
    "firstName": "Sweep",
    "lastName": "Test",
    "companyName": "Sweep Inc.",
    "beneficiaryCountry": "MT",
    "beneficiaryPostalCode": "58585858",
    "beneficiaryCity": "Malta",
    "beneficiaryAddressLine": "BeneficiaryAddressLineOR3520",
    "bankAccountCountry": "MT",
    "bankName": "SWEEP BANK",
    "bic": "CFTEMTM1",
    "iban": "MT39CFTE28004000000000000001297",
    "bankAccountHolderName": "Sweep Inc."
  },
  "status": "IN_PROGRESS",
  "transferTransactionId": "2ef45493-6594-44ea-9170-647802427f5c",
  "transferShortId": "20220922-PRZFLA",
  "endToEndReference": "9fbac239-a531-4413-890d-9be41784e517"
}