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.