Payment gateways
A payment gateway takes a payment online and tells Full Fabric when it has gone through. Full Fabric supports Stripe, PayPal, Flywire and Adumo, plus an External gateway that sends applicants to a payment page of the institution's own. The gateway records the payment as a transaction on the fee or application it was for.
Which gateway pays what
| Gateway | Application fees | Payment plan fees | How the payer pays | Refunds in Full Fabric |
|---|---|---|---|---|
| Stripe | Yes | Yes | Card form inside the page; iDEAL by bank redirect | Yes |
| PayPal | Yes | No | Redirect to PayPal and back | No |
| Flywire | Yes | Yes | Flywire checkout window, after billing details | No |
| Adumo | Classic application form only | No | Redirect to the Adumo payment page and back | No |
| External | Yes | No online payment | A button linking to the institution's own page | Not applicable |
The new application experience takes Stripe, Flywire, and PayPal for application fees. For any other gateway it shows "Online payment is not available for this application. Please contact the institution." The student Payments page pays plan fees through Stripe or Flywire; fees on any other gateway show no pay button.
Setting up a gateway
Gateways are set up under Settings > General settings > Other integrations > Payments, with one page per gateway, by staff who can change the institution's integration settings. Each page shows whether the gateway is Active or Inactive and has an Enable / Disable button. Saved secrets are masked, and a secret field is only overwritten when something new is typed into it. Gateways cannot be deleted, only disabled; a disabled gateway is no longer offered when choosing a gateway.
| Gateway | What to enter |
|---|---|
| Stripe | Publishable key, Secret key and Signing secret from the Stripe dashboard. Under Payment methods, Cards are always available and iDEAL can be switched on. |
| PayPal | API username, API password and Signature, from the PayPal account's API access. Test connection checks them with PayPal. |
| Flywire | One or more gateways, each with a Name, the Recipient code Flywire gave you, and a Shared secret. |
| Adumo | Endpoint, Merchant ID, Application ID and Secret, from the Adumo merchant account. |
Warning: Without a Stripe Signing secret, Stripe's payment notifications are not verified. Without a Flywire Shared secret, only notifications from Flywire's IP addresses are trusted. Set both.
Flywire is the only gateway an institution can have several of, for example one per Flywire recipient account. Stripe, PayPal, Adumo and External exist once each.
Choosing a gateway for a fee
- Application fees: on the application template's Payment tab, choose the Gateway. Without one, the payment page does not appear and applicants can submit without paying. Programme-specific fees can each have their own gateway, used when every programme the applicant chose resolves to the same gateway.
- Payment plan templates and plans: on the Details tab, set Payment process to Process and track payments in Full Fabric and choose a Gateway. Payments managed externally means no online payment; staff record payments as manual transactions.
- One fee or a set of instalments: the fee's Gateway overrides the plan's. It defaults to Plan default, or Partition default for an instalment.
A fee uses its own gateway first, then its set of instalments' gateway, then the plan's. A fee with its own gateway can be paid online even on a plan whose payments are managed externally.
Stripe
The applicant pays without leaving the page. Card payments always ask for 3-D Secure. iDEAL is offered only for fees in euros and only when it is switched on; it sends the applicant to their bank and back. Stripe is given the profile's email address for its receipt.
Stripe reports the outcome to Full Fabric through webhooks. A successful charge completes the transaction and marks the fee or application paid; a failed or cancelled payment marks the transaction Failed and the fee unpaid again.
Refunds. A successful Stripe payment made in the last 30 days can be refunded from the profile's transactions list by staff with the refund permission. The Refund transaction dialog asks for a Reason (Duplicate payment, Fraudulent payment, Requested by customer) and a Description. The whole payment is refunded; partial refunds are not available. See Transactions.
PayPal
The applicant is sent to PayPal to approve the payment and brought back to the application. The payment is completed as soon as they return, and the application fee is marked paid. If they cancel at PayPal, nothing changes and they are not charged.
Flywire
The payer first fills in billing details (first name, last name, email, phone number, address, country, city and zip code, with state and a second address line optional), then pays in Flywire's checkout window. For a plan fee, the amount is what is still outstanding on the fee.
Flywire reports back to Full Fabric as the transfer progresses:
| Flywire status | In Full Fabric |
|---|---|
| Initiated | Transaction Initiated; the fee shows as pending payment |
| Guaranteed | Transaction Guaranteed; counts as paid |
| Cancelled | Transaction Cancelled; the fee is outstanding again |
While a transfer is initiated, the payer sees that the institution is awaiting confirmation of their payment, and can choose another payment method. When an application fee is guaranteed, the applicant receives Email for candidates when a payment is received through flywire. No such email is sent for plan fees.
Adumo
The applicant is sent to the Adumo payment page and returned to the application's payment tab. The transaction is marked Succeeded and the fee paid, or Failed with Adumo's error recorded. Adumo is available in the classic application form only.
External
The External gateway has no credentials. On the application template, staff set the Button text (per language) and Button link. The applicant sees a button that opens the link in a new tab. Full Fabric records nothing and does not require the fee to be paid before submission; staff record the payment as a manual transaction when it arrives.