Granting credits with MemberPress
You can give employers job-posting credits when a MemberPress transaction completes, and again on each recurring payment. It works like the PMPro guide.
Use this guide when:
- You use MemberPress to manage members.
- You want credit allotments tied to memberships.
Before you start
Section titled “Before you start”- MemberPress is installed and active, and you have at least one membership.
- To charge for posting, set a credit cost on a board. See Credit packages and costs.
Step 1: Map a membership to credits
Section titled “Step 1: Map a membership to credits”- Go to Career Board -> Settings -> Credits and find the Credit mappings card.
- In Product / Plan, pick the membership. MemberPress memberships sit under the “MemberPress” heading. If MemberPress shows as not installed in the Detected providers card, its memberships are not offered here.
- Enter the credits granted, for example
50. - Click + Add Mapping.
Step 2: How the grant works
Section titled “Step 2: How the grant works”- When a transaction completes for the membership, the mapped credits are added once per transaction.
- On each recurring payment, the new transaction adds the credits again.
- On cancellation or expiry, nothing is removed. To take credits back, use a manual adjustment.
The employer’s Credits tab lists the membership under Buy through the store. Buy opens the membership page.
Step 3: Test the flow
Section titled “Step 3: Test the flow”- Subscribe to the mapped membership with a test account.
- Open the Credits tab of that member’s employer dashboard. The balance shows the mapped amount.
- Transaction History shows a top-up for it.
Common patterns
Section titled “Common patterns”A trial plus a paid plan. Create a free trial membership mapped to 5 credits and a paid one mapped to 50. Each completed transaction adds its own mapped credits.
One-time membership, one-time grant. Map a non-recurring membership. The member gets the credits once and keeps them until they are spent.
Read a balance in code. The balance is the sum of the ledger, not a user-meta value. Read it with \Wbcom\Credits\Credits::get_balance( 'wp-career-board', $user_id ) or over REST at GET /wcb/v1/employers/{id}/credits.
Troubleshooting
Section titled “Troubleshooting”A member paid but got no credits. Check that the membership has a mapping row and that MemberPress shows as active in Detected providers.
A payment is still pending. Credits are added only when MemberPress marks the transaction completed. If it is still pending, check the payment gateway first.