These transaction schemas cover the most common pay in, also known as money in, transaction tasks in Payabli.

Make a transaction with the embeddedMethodUI component

Making a transaction with the embeddedMethodUI component happens over several steps. Use the component to store payment methods and make a payment transaction.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

Run payabliExec(method, parameters) Here, the action is set to method. Send the paymentDetail and customerData object in parameters.

Payment method saved The payment method is saved and includes the data sent as parameters. An ID for the payment method is returned, which is then used to make transactions.

Callback function Use a callback function to send a transaction that uses the new payment method.

Response

Save a payment method with the API

You can save a payment method using the API with the token storage endpoint. If you want to store the token permanently, make sure that the temporary query parameter is set to false.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

POST to addMethod endpoint

Make a POST request to the addMethod endpoint. Set temporary to true to create a single use token that’s good for 12 hours. Set temporary to false to save a permanent token.

Response

Make a transaction with a stored payment method

If you already have a stored payment method for the user, you can just make a POST request to the getPaid endpoint using the storedMethodId.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

POST to transaction endpoint
using storedMethodId

Make a POST request to a transaction endpoint (like /MoneyIn/getpaid). Use the saved method’s storedMethodId in the paymentMethod object.

Response

Void, refund, and reverse transactions

Learn more about the difference between voids, refunds, and reversals in Void, Refund, or Reverse a Transaction.

Void a transaction

To void an unsettled transaction, send a GET request to the /MoneyIn/void/{transID} endpoint using the transaction’s referenceID as the transId parameter.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

GET to void endpoint
using transId

Make a GET request to the void endpoint (/MoneyIn/void), using the referenceId returned with the transaction as the transId parameter.

Response

Refund a transaction

To refund a settled transaction, send a GET request to the /MoneyIn/refund endpoint with transId and amount parameters.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

GET to return endpoint
using transId and amount

Make a GET request to the refund endpoint (/MoneyIn/refund), using the referenceId returned with the transaction as the transId parameter. You must specify the amount to refund.

Response

Reverse a transaction

To reverse a transaction, send a GET request to the /MoneyIn/reverse endpoint with transId and amount parameters.

This flowchart explains the basic steps for the task. Hover over a step for more information.

Start

GET to reverse endpoint
using transId and amount

Make a GET request to the reverse endpoint (/MoneyIn/reverse), using the referenceId returned with the transaction as the transId parameter. You must specify the amount to refund.

Response