Skip to main content
Hidden
Note
This feature is currently in limited-availability alpha and subject to change. To learn more about the alpha program for this feature, contact your Marqeta representative.
Marqeta’s Bill Pay service offers a RESTful API solution that lets you search for billers, link billers to a user’s account, and make payments to billers. Bill Pay v1.0 supports the use of Marqeta-issued debit cards. Support for ACH money movement will be available at a later time. Authentication Security Authorization for Bill Pay follows the same requirements as Marqeta’s Core API. Customers must pass in Basic Authorization with their assigned Application Token and Access Token. For example:
Bash
curl -X `POST` --user application_token:user_access_token \
    -H "Content-Type: application/json" \
    --data-raw '{"name": "Marqeta"}' \
    "https://billpay-sandbox-api.marqeta.com/v0/billers/search"
To use Bill Pay, a user account holder must already exist within Marqeta with all basic information configured (first name, last name, email, address). The user’s token will be required in most calls to Bill Pay.

​
User Enrollment - POST /users

You must first enroll a user in Bill Pay through the POST /users endpoint.

​
Search Billers - POST /billers/search

You can then search for billers using the POST /billers/search endpoint. A list of billers will be returned with some additional information. Each biller has different requirements for linking to a user’s account. To see detailed information for a biller, the fields returned in detail_search_fields for a given biller should be provided in a follow-up search request. (See the Billers > POST /billers/search endpoint for additional information.) A biller’s biller_token and address_token can be found within search results when a user has provided the necessary information for a biller. These fields can be used to add the biller as a payee to the user’s account.

​
Link Payee - POST /users/{userToken}/payees

A payee is a link between user and biller. Once the biller_token and address_token have been retrieved for a biller, the user can add the biller as a payee to their Bill Pay account by providing this information and the account_number associated with the biller.

​
Make a Payment - POST /users/{userToken}/payments

Once a user has a payee, the user can make a payment to the payee by providing the user’s token, the amount to pay (in $USD), payee token, and the token of a Marqeta-issued debit card they would like to use for payment.

Related topics

Bill PaymentsBill Pay UsersPaymentsPayment SchedulesPush-to-Card Payments