Generate credits for testing purposes

Generate a credit (inbound payment) to a budget in sandbox.

This endpoint is for testing purposes only and won't work in production.

SecurityCommonAuth
Request
query Parameters
accountId
required
string

The ID of the account to work with.

Example: accountId=F50091
Request Body schema: application/json

Body

thirdPartyReference
string

A unique reference provided by your integrating product.

budgetId
required
string <uuid> <= 36 characters

The ID of the budget to work with.

orderId
string

The ID of the order used to fulfil the transfer request.

accountIdentifier
string

Identifier of the account, could be iban or account number

settlementPriceAmount
required
string^[0-9]+$

The settlement amount.

settlementPriceCurrency
required
string
Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYN" "BZD" "CAD" "CDF" "CHF" "CLP" "CNY" "COP" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GGP" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LVL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MUR" "MVR" "MWK" "MXN" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SEK" "SGD" "SHN" "SLL" "SOS" "SRD" "SSP" "STN" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "UYU" "UZS" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XCD" "XOF" "XPD" "XPF" "XPT" "YER" "ZAR" "ZMK" "ZMW" "ZWD"
remittersName
required
string

The name of the remitter.

reference
string

The reference of the credit.

bankIdentifier
string^[0-9]+$

The bank identifier.

remittersAddress
required
string

The remitter's address.

beneficiaryName
required
string

The name of the beneficiary of the credit.

institutionName
string <= 35 characters

The name of the institution making the credit.

institutionAddress
string <= 109 characters

The address of the institution making the credit.

schemeName
string

The name of the scheme used to process the credit.

Enum: "FasterPayment" "BACS" "CHAPS" "Swift" "SEPA"
Responses
200

OK

post/budgets/generate-credit
Request samples
application/json
{
  • "thirdPartyReference": "1e3f1734-6f7a-17e5-ae22-11cd18757ef4",
  • "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  • "orderId": "string",
  • "accountIdentifier": "string",
  • "settlementPriceAmount": "string",
  • "settlementPriceCurrency": "USD",
  • "remittersName": "William Walker",
  • "reference": "REF-123-456",
  • "bankIdentifier": "string",
  • "remittersAddress": "41 Middle Street, Enfield, EN1 3JY",
  • "beneficiaryName": "John Smith",
  • "institutionName": "string",
  • "institutionAddress": "string",
  • "schemeName": "FasterPayment"
}
Response samples
application/json
{ }