Skip to content
Docs

Granting Credits via MemberPress

The MemberPress adapter works the same way as PMPro - a member buys a membership product, the membership grants a credit amount, every renewal tops up again.

Use this guide when:

  • You use MemberPress to manage members and access rules.
  • You want tiered credit allotments based on membership level.
  • You want recurring credit grants tied to MemberPress renewals.

Prerequisites

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

Step 1: Map a Membership to Credits

Section titled “Step 1: Map a Membership to Credits”
  1. Go to Career Board → Settings → Credits.
  2. Scroll to Credit Mappings. In the Product / Plan dropdown, pick your membership - MemberPress memberships appear under the “MemberPress” group. (If MemberPress shows “not installed” in the adapter list above, its memberships won’t appear here.)
  3. Enter the credit amount granted per cycle (e.g. 50).
  4. Click + Add Mapping.

Step 2: How the Grant Works

Section titled “Step 2: How the Grant Works”
  • On signup - the mepr_event_transaction_completed event fires; the adapter writes a topup ledger row for the mapped amount.
  • On renewal - the same event fires for recurring memberships; another topup row each cycle.
  • On cancellation / expiry - no automatic deduction. The member keeps the balance they had. To claw credits back, use a manual adjustment.
  • On manual transaction creation (via MemberPress admin) - the same event fires, same grant happens.

Step 3: Test the Flow

Section titled “Step 3: Test the Flow”
  1. MemberPress → Memberships → choose your mapped membership.
  2. Use the Membership URL to subscribe with a test account.
  3. Complete checkout.
  4. As that member, visit Career Board → Employer Dashboard.
  5. Confirm the balance shows the mapped amount.
  6. The Credit Balance block (Transaction History) shows a topup row for the granted amount.

Common Patterns

Section titled “Common Patterns”

Trial + paid combination.

Create two memberships: “Trial (free, 5 credits, 7 days)” and “Premium (paid recurring, 50 credits/month)”. Map each. MemberPress handles the transition; the adapter responds to whichever transaction event fires.

One-time membership = one-time credit grant.

Map a non-recurring membership to a credit amount. Member buys once, gets the credits once. They keep the credits indefinitely; they just don’t get more without buying again.

Reading a member’s credit balance in code.

The balance is computed from the append-only credit ledger, not stored in a user-meta field. Read it programmatically with \Wbcom\Credits\Credits::get_balance( 'wp-career-board', $user_id ), or over REST at GET /wcb/v1/employers/{id}/credits. There is no _wcb_credit_balance user-meta key to query directly.

Troubleshooting

Section titled “Troubleshooting”

Member completed checkout but no credits. On Career Board → Settings → Credits, the adapter list shows MemberPress as active or “not installed”. If it shows “not installed” while MemberPress is active, deactivate and reactivate Career Board Pro. Also confirm the membership has a mapping row.

Webhook-based payment didn’t credit. The adapter grants on the mepr_event_transaction_completed event, which fires only after the payment gateway confirms. If a transaction is still “Pending” (MemberPress → Reports → Transactions), no credits fire. Investigate the gateway first.

Section titled “Related”