PayPal
PayPal takes application fees. The applicant leaves Full Fabric for PayPal's site, approves the payment there and is sent back; Full Fabric then completes the payment with PayPal and marks the fee paid. Full Fabric connects with your PayPal account's API credentials. PayPal cannot take payment plan fees: use Stripe or Flywire for those. See Payment providers for what all providers share.
How it works
Connecting PayPal
Go to Settings → Other integrations → PayPal.
The API credentials card holds the values from your PayPal account, under API access. Click Add credentials (or Update credentials), fill in the fields and click Save credentials.
| Field | Notes |
|---|---|
| API username | Shown once saved |
| API password | Masked once saved |
| Signature | Masked once saved |
Once all three are saved, click Test connection to check them with PayPal:
| Result | Meaning |
|---|---|
| Connected. PayPal accepted these credentials. | The credentials work |
| PayPal rejected these credentials. Check them in your PayPal account and update them here. | PayPal refused them |
| The connection could not be tested. Try again. | The check itself failed |
The test runs against the saved credentials, so save changes before testing; saving clears the previous result. Click Enable in the page header to offer PayPal.
Test and live mode
There is no test-mode switch. On Full Fabric's production platform, payments always go to PayPal's live site.
What applicants see
- Classic application form: the PayPal logo and pay with PayPal, which opens PayPal in a new tab. After paying, PayPal brings the applicant back to the application's payment tab.
- New application experience: the page explains that the applicant will be redirected to PayPal and brought back. The pay button leaves for PayPal in the same tab and returns to the payment page.
On PayPal, the payment shows your institution's name and the fee description. No shipping address is asked for.
How payment status comes back
There is no webhook: the result comes back with the applicant.
- The transaction is recorded as Pending when the applicant leaves for PayPal.
- When the applicant returns after approving, Full Fabric asks PayPal to complete the payment. If PayPal confirms, the transaction becomes Succeeded, PayPal's transaction ID becomes its reference, and the application fee is marked paid.
- If PayPal refuses, the transaction becomes Failed, and the new application experience shows Your payment could not be completed. Please try again.
- If the applicant cancels on PayPal, they come back to the payment page, which in the new application experience shows Your PayPal payment was cancelled. You have not been charged. The transaction stays Pending.
Note: The payment is only completed when the applicant comes back from PayPal. An applicant who approves the payment and closes the window before returning is not charged, and the transaction stays Pending.
Refunds are not available for PayPal payments in Full Fabric.
Common failures
| What you see | Usual cause | Fix |
|---|---|---|
| PayPal rejected these credentials. on Test connection | A wrong API username, password or signature | Copy them again from your PayPal account and save |
| Test connection cannot be clicked | One of the three credentials is not saved | Save all three |
| Applicants come straight back from the pay button with Your payment could not be completed. Please try again., or to an unpaid payment tab on the classic form | PayPal would not set up the payment, for example because the credentials are wrong | Run Test connection and fix the credentials |
| Many Pending PayPal transactions | Applicants left for PayPal and cancelled, or never came back | None: a pending transaction is not money on its way |
| Online payment is not available for this application. Please contact the institution. (new application experience) | PayPal is disabled | Enable PayPal |
| No way to pay a payment plan fee | The plan's gateway is PayPal, which has no checkout for plan fees | Switch the plan to Stripe or Flywire |
Permissions
The page opens with Global integrations; see Payment providers for what saving it takes, and Permissions.