Browse documentation

Work on an issue

From project contribution and review to acceptance and payment

alexanmtz Written by
Contribute with this documentation

Table of contents

Gitpay helps contributors move from useful project work to an accepted contribution and payment. A funded issue is one route; the broader contribution path can also begin through a project’s usual collaboration process. Agree on payment with the project before treating that work as paid.

Choose and understand the work

Browse project tasks or start from an issue you are already discussing with a maintainer. Read the scope, acceptance criteria, repository instructions, and payment status. Ask what is excluded and who will review the result.

Apply and confirm assignment

For a funded task, explain your approach and request assignment. Gitpay checks the underlying GitHub issue assignment when confirming a claim. Wait for confirmation before relying on the bounty. See Claims for the claim process.

Deliver a reviewable contribution

  1. Create a focused branch or fork according to the repository’s instructions.
  2. Make the change and run relevant checks.
  3. Open a Pull Request linked to the issue, with a short summary and test evidence.
  4. Respond to review comments and keep the scope discussion visible.

See Git workflow and Pull Requests for practical details.

Acceptance and payment

A submitted Pull Request is a delivery, not automatic acceptance. The maintainer checks the agreed criteria, then confirms and releases payment through the applicable task workflow. Your transfer can appear in Claims before it is ready for payout.

If you made a valuable contribution before a task was funded, ask the project whether it wants to recognize and pay for that work. The exact amount, recipient, and payment route need agreement; Gitpay does not automatically price past contributions.

When work is blocked

Explain what you tried and ask a specific question on the issue or Pull Request. If requirements change, get the new scope and payment expectation in writing before continuing.

Next steps