Gateway JIT Funding Scenarios

You can use the Gateway JIT (Just-in-Time) Funding feature to participate in funding decisions. Using Gateway JIT Funding adds a layer of complexity to the transaction lifecycle because your gateway must receive and respond to transaction requests.

This page describes several Gateway JIT Funding transaction flows and where your gateway fits in each.

For more information on JIT Funding, see About Just-in-Time Funding.

Authorizations and clearings

An authorization occurs when a card holder attempts to make a payment. If the authorization is successful, a clearing transaction follows, which actually moves the necessary funds.

When a card holder attempts to make a payment (without using a PIN), the following process occurs:

  1. The merchant initiates the payment attempt and sends an authorization message to the card network.
  2. The card network sends an authorization message to the Marqeta platform.
  3. The Marqeta platform sends a JIT Funding request to your gateway and includes relevant transaction data to assist in your decision-making process.
  4. Your gateway makes a decision and responds by either approving or declining the funding request.
  5. The Marqeta platform sends an authorization response to the card network and a notification to you via a webhook that you can use to validate the authorization and update account balances.
  6. The card network sends an authorization response to the merchant.
  7. The merchant receives the authorization response.

If the authorization was approved, the following process occurs:

  1. The merchant submits a capture request to the card network.
  2. The card network sends a clearing record to the Marqeta platform.
  3. The Marqeta platform sends a clearing notification to you via a webhook.
  4. The Marqeta platform completes the transaction.

Debit card PIN transactions

A PIN debit transaction occurs when a card holder uses their PIN at a point of sale to make a payment.

When a card holder attempts to make a payment using their PIN, the following process occurs:

  1. The merchant initiates the payment attempt and sends a PIN debit message to the card network.
  2. The card network sends a PIN debit message to the Marqeta platform.
  3. The Marqeta platform sends a JIT Funding request to your gateway and includes relevant transaction data to assist in your decision-making process.
  4. Your gateway makes a decision and responds by either approving or declining the funding request.
  5. The Marqeta platform sends a PIN debit response to the card network and a PIN debit notification to you via a webhook that you can use to validate the PIN debit details and update account balances.
  6. The card network sends a PIN debit response to the merchant.

Withdrawing funds from an ATM triggers a very similar flow. When a card holder withdraws funds from an ATM, the following process occurs:

  1. The card holder attempts to withdraw funds from an ATM, and the ATM sends an ATM withdrawal message to the card network.
  2. The card network sends an ATM withdrawal message to the Marqeta platform.
  3. The Marqeta platform sends a JIT Funding request to your gateway and includes relevant transaction data to assist in your decision-making process.
  4. Your gateway makes a decision and responds by either approving or declining the funding request.
  5. The Marqeta platform sends an ATM withdrawal response to the card network and an ATM withdrawal notification to you via a webhook that you can use to validate the ATM withdrawal details and update account balances.
  6. The card network sends an ATM withdrawal response to the ATM.

Refunds

A refund occurs when a card holder requests that the merchant return funds from a previous transaction after the clearing process has completed.

When a card holder attempts to get a refund from the merchant, the following process occurs:

  1. The merchant initiates a refund request by sending the request to the card network.
  2. The card network sends the refund request to the Marqeta platform.
  3. The Marqeta platform sends a refund notification to you via a webhook. Your system updates the account balance data it holds using transaction data in the notification.
  4. The Marqeta platform completes the transaction.

Reversals

A reversal occurs when a merchant cancels a transaction after the authorization succeeds but before the clearing process occurs.

When a merchant requests a reversal, the following process occurs:

  1. The merchant cancels the transaction prior to capture and sends a reversal message to the card network.
  2. The card network sends a reversal message to the Marqeta platform.
  3. The Marqeta platform sends a reversal notification to you via a webhook. Your system updates the account balance data it holds using transaction data in the notification.
  4. The Marqeta platform completes the transaction.

Tips

A tip transaction occurs when an original authorization amount is updated with a new amount, like when a card holder makes a purchase at a restaurant and adds a tip on top of the original price.

When a card holder attempts a tip transaction, the following process occurs:

  1. The merchant initiates the payment attempt and sends an authorization message to the card network.
  2. The card network sends an authorization message to the Marqeta platform.
  3. The Marqeta platform sends a JIT Funding request to your gateway and includes relevant transaction data to assist in your decision-making process.
  4. Your gateway makes a decision and responds by either approving or declining the funding request.
  5. The Marqeta platform sends an authorization response to the card network and a notification to you via a webhook that you can use to validate the authorization and update account balances.
  6. The card network sends an authorization response to the merchant.
  7. The merchant calculates the transaction total (including tip) and batches the transaction.
  8. The merchant submits a capture request to the card network.
  9. The card network creates a clearing record that replaces the authorization amount with the new amount that includes the tip and sends it to the Marqeta platform.
  10. The Marqeta platform sends a clearing notification to you via a webhook. Your system makes any necessary updates to the account balance data it holds.
  11. The Marqeta platform completes the transaction.

Automated fuel dispenser transactions

An automated fuel dispenser transaction occurs when a card holder purchases gas directly from the fuel dispenser.

When a card holder initiates an automated fuel dispenser transaction, the following process occurs:

  1. Before the card holder pumps the fuel, the merchant initiates a fuel transaction and sends a pre-authorization request to the card network.
  2. The card network sends the authorization request to the Marqeta platform.
  3. The Marqeta platform sends a JIT Funding request to your gateway and includes relevant transaction data to assist in your decision-making process.
  4. Your gateway makes a decision and responds by either approving or declining the funding request.
  5. The Marqeta platform sends an authorization response to the card network and a notification to you via a webhook that you can use to validate the authorization and update account balances.
  6. If approved, the card holder pumps the fuel.
  7. The automated fuel dispenser sends an auth advice message to the card network.
  8. The card network sends an auth advice message to the Marqeta platform to update the original authorization to the final amount of the fuel purchase.
  9. The Marqeta platform sends an auth advice message to you via a webhook. Your system makes any necessary updates to the account balance data it holds.
  10. The Marqeta platform sends an auth advice acknowledgement to the card network.
  11. The card network receives the auth advice acknowledgement from the Marqeta platform.
  12. The merchant submits a capture request to the card network for the final purchase amount.
  13. The card network sends a clearing record to the Marqeta platform.
  14. The Marqeta platform sends a clearing notification to you via a webhook.
  15. The Marqeta platform completes the transaction.