Skip to content
Docs

Granting Credits via Paid Memberships Pro

Use this when you want employers to subscribe to a membership level that includes job-posting credits - instead of buying credit packs one at a time.

Use this guide when:

  • You already use Paid Memberships Pro to gate access on your site.
  • You want a “Gold tier: 100 credits/month, Silver tier: 25/month” pricing structure.
  • You want to grant credits automatically on a membership level upgrade (or take them away on downgrade).

Prerequisites

Section titled “Prerequisites”
  • Paid Memberships Pro is installed and active.
  • You’ve created at least one Membership Level (PMPro → Membership Levels).
  • The credit system is active automatically (it ships with Pro). There is no separate “enable credits” toggle.

Step 1: Map a Level to a Credit Amount

Section titled “Step 1: Map a Level to a Credit Amount”
  1. Go to Career Board → Settings → Credits.
  2. Scroll to Credit Mappings. In the Product / Plan dropdown, pick your membership level - PMPro levels appear under the “Paid Memberships Pro” group. (If PMPro shows “not installed” in the adapter list above, its levels won’t appear here.)
  3. Enter the credit amount granted on every renewal (e.g. 100).
  4. Click + Add Mapping.

Repeat for each tier you want to offer.

Step 2: How the Grant Works

Section titled “Step 2: How the Grant Works”
  • On first checkout - when a member completes payment for a level, the mapped credit amount is added immediately (one topup ledger row).
  • On renewal - for recurring levels, every renewal adds the same credits (a fresh topup row each cycle). Credits do NOT roll over by default - see “Rolling vs Resetting” below.
  • On cancellation / expiry - no automatic deduction. The member keeps whatever balance they had. If you need to claw credits back on expiry, do it with a manual adjustment.

Step 3: Test the Flow

Section titled “Step 3: Test the Flow”
  1. Go to PMPro → Membership Levels → choose your mapped level → Test Checkout.
  2. Use a test card (or a free level with a temporary discount code).
  3. Complete the checkout.
  4. As that test user, visit Career Board → Employer Dashboard.
  5. The credit balance shows the mapped amount.
  6. The Credit Balance block (Transaction History) shows a topup row for the granted amount.

Credits accumulate

Section titled “Credits accumulate”

Credits accumulate - if Gold gives 100/month and the employer doesn’t post any jobs, after 3 months they have 300 credits. The credit system has no automatic “reset to allotment on renewal” option. If you need to reset a balance, use a manual adjustment (deduct the leftover, or top up to the target).

Common Patterns

Section titled “Common Patterns”

Free trial: 5 credits, then 100/month on upgrade.

  1. Create a “Free Trial” PMPro level (price $0).
  2. Map it to 5 credits.
  3. Create your paid level (“Employer Gold”).
  4. Map it to 100 credits.

When the trial member upgrades, they get 5 + 100 = 105 (credits accumulate). If you’d rather they end up with only 100, deduct the leftover 5 with a manual adjustment.

Annual plans.

PMPro supports annual recurring levels - the adapter listens for the renewal payment event regardless of cycle length, so the mapping works the same way for monthly or yearly plans.

Troubleshooting

Section titled “Troubleshooting”

Member subscribed but no credits added. On Career Board → Settings → Credits, the adapter list shows Paid Memberships Pro as active or “not installed”. If it shows “not installed” while PMPro is active, deactivate and reactivate Career Board Pro. Also confirm the level has a mapping row.

Test transactions don’t add credits. The adapter grants on the pmpro_after_change_membership_level hook (initial checkout / level change) and pmpro_subscription_payment_completed (renewals). Test modes that don’t fire those hooks won’t trigger credits. Use PMPro’s “Test Checkout” link instead.

Renewal didn’t add credits. Renewals grant on pmpro_subscription_payment_completed. If the renewal isn’t logged in PMPro (PMPro → Memberships → Reports), the credit grant won’t fire either - investigate the gateway first.

Section titled “Related”