Skip to main content
Once you’ve resolved a target country and university, initiate the tuition payment.

​
Endpoint

POST https://api-v3.reeple.ai/tuitions/create

​
Request body

FieldTypeDescription
amountNumber >= 2000Required. Amount to pay.
countryStringRequired. Country where the university is located.
currencyStringRequired. Currency for the payment.
studentObject (CreateBeneficiaryDto)Required. Details of the tuition payment’s beneficiary.
typeEnum SCHOOL | ACCOMODATIONRequired. Transaction type.
universityObject (UniversityDto)Required. The target university.
addressStringAddress of the person paying the tuition.
referenceStringYour unique identifier for this request.
saveStudentBooleanWhether to save the student’s information for future use.

​
Currency support

CurrencySupportedNotes
GBPYesUses a dedicated tuition payout path with institution validation and education-purpose routing
Other configured tuition currenciesYesContinue through the general tuition flow

​
KYC and AML requirements

RequirementAppliesNotes
Business wallet must be fundedYesThe wallet must cover amount plus fee
Institution details must be validYesTuition validation happens before processing
Education purposeRequired for GBPGBP tuition is locked to education
Provider confirmationAsynchronousFinal status may arrive after the initial request, via webhook
{
  "type": "SCHOOL",
  "country": "string",
  "university": {
    "name": "string",
    "accountName": "string",
    "accountNumber": "string",
    "accountBank": "string",
    "accountType": "SAVINGS",
    "sortCode": "string",
    "iban": "string",
    "swiftCode": "string",
    "UCASNumber": "string",
    "routingNumber": "string",
    "postCode": "string",
    "state": "string",
    "city": "string"
  },
  "address": "string",
  "amount": 2000,
  "reference": "string",
  "currency": "GBP",
  "student": {
    "reference": "string",
    "email": "string",
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "invoiceNumber": "string",
    "address": "string",
    "note": "string"
  },
  "saveStudent": true
}

​
Response

{
  "success": true,
  "statusCode": 201,
  "message": "Tuition created successfully",
  "data": {
    "id": "d68c05d7-854a-4fb8-8f44-3dac7fd38ecc",
    "country": "GB",
    "university": {
      "iban": "123211",
      "name": "University of London",
      "sortCode": "3737378",
      "swiftCode": "2928282",
      "UCASNumber": "ejhbe873bd83be93y36v",
      "accountName": "Example bank of GB",
      "accountType": "SAVINGS",
      "accountNumber": "37383837329"
    },
    "createdAt": "2024-04-25T06:22:48.443Z",
    "updatedAt": "2024-04-25T06:22:50.361Z",
    "deletedAt": null,
    "type": "SCHOOL",
    "currency": "GBP",
    "studentId": "e6372fea-5943-479a-a12a-f4b4fdaeb0ab",
    "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
    "reference": "reeple_business_12345",
    "transaction": {
      "id": "4945bf9f-68bc-4e0b-988f-7c71821895a6",
      "amount": 1000,
      "status": "PENDING",
      "fee": 0,
      "description": "Tuition",
      "type": "CREDIT",
      "medium": "API",
      "method": null,
      "currency": "GBP",
      "createdAt": "2024-04-25T06:22:48.443Z",
      "updatedAt": "2024-04-25T06:22:48.443Z",
      "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
      "reference": "rep_tr_7ca4294c-36c9-42cf-8eb4-349a4dfe8d09",
      "depositId": null,
      "spendingId": null,
      "refundId": null,
      "topupId": null,
      "tuitionId": "d68c05d7-854a-4fb8-8f44-3dac7fd38ecc",
      "walletId": null,
      "cardId": null,
      "swapId": null,
      "balance": null
    }
  }
}