Get Sandbox Keys
API Reference

Create ACH / Same Day ACH Transfer

post
https://api.cloud.mbanq.com/v1/payments (for ACH Transfer)

Note: All the payment API's have the endpoint: /payments

Use this API for initiating an outgoing ACH or Same Day ACHtransfer to an external account.

ACH: ** Settlement Timeline **: Refer ACH lifecycle for details of the same

The below notifications are generated for lifecylce changes associated with an ACH transfer.

SAME DAY ACH: Cut-off Time: 10:45 AM ET (Due to the 11:00 AM cut-off time)

Transfer funds to the recipient's account on the same business day if initiated before 10:45 AM ET.

If Same Day ACH is selected, ensure the request is submitted before 10:45 AM ET to meet the 11:00 AM cut-off time.

** Common Behaviour **: A successful response from this API indicates that the transfer was successfully initiated. The transfer amount is debited on the Originator account. To get the actual status of the transfer, please subscribe to the webhooks detailed below.

** Flow of Funds **:

  • Originator to Recipient (PaymentType : CREDIT)
  • Recipient to Originator (PaymentType : DEBIT)
FunctionWebhook
Transfer InitiationTransfer Initiation
Transfer SubmittedTransfer Submitted
Transfer ReturnTransfer Returned
Body Params

Note: All the payment API's have the endpoint: /payments

Use this API for initiating an outgoing ACH or Same Day ACHtransfer to an external account.

ACH: ** Settlement Timeline **: Refer ACH lifecycle for details of the same

The below notifications are generated for lifecylce changes associated with an ACH transfer.

SAME DAY ACH: Cut-off Time: 10:45 AM ET (Due to the 11:00 AM cut-off time)

Transfer funds to the recipient's account on the same business day if initiated before 10:45 AM ET.

If Same Day ACH is selected, ensure the request is submitted before 10:45 AM ET to meet the 11:00 AM cut-off time.

** Common Behaviour **: A successful response from this API indicates that the transfer was successfully initiated. The transfer amount is debited on the Originator account. To get the actual status of the transfer, please subscribe to the webhooks detailed below.

** Flow of Funds **:

  • Originator to Recipient (PaymentType : CREDIT)
  • Recipient to Originator (PaymentType : DEBIT)
FunctionWebhook
Transfer InitiationTransfer Initiation
Transfer SubmittedTransfer Submitted
Transfer ReturnTransfer Returned

string
enum
required
Defaults to CREDIT

Specifying the type of payment during the transfer. Pattern: CREDIT/DEBIT is allowed. Example: CREDIT

Allowed:
string
enum
required
Defaults to ACH

ACH would be the default payment rail for ACH debit/credit transfer. SAMEDAYACH would be the default payment rail for Same Day ACH credit transfer. Example: ACH

Allowed:
number
required
Defaults to 10

The amount to be transferred in USD. Pattern: Maximum amount is defined by the transfer limits configured. Example: 10

originator
object
required

The details of the originator for ACH transfer.

recipient
object
required

The details of the recipient/creditor for the ACH transfer.

string
length ≤ 80

Optional reference or description for the transaction. Character Restrictions Encoding: ASCII (restricted subset) Allowed Characters:

Uppercase letters: A-Z Digits: 0-9 Special characters: space , hyphen -, period ., slash /, colon :, parentheses (), ampersand &

Restrictions:

No accented characters (é, ñ, ü, etc.) No non-Latin alphabets No special characters: @, #, $, %, *, and similar symbols

Data Handling:

Fields with invalid characters will be rejected Accented characters must be transliterated (e.g., é → E, ñ → N)

Example: transferring to amy

string

Unique identifier for tracking the transaction. Maximum length: 100 characters. Example: 6B56xh4DxD5gmYzEjpuZn11dfsdfsd1f

Headers
string
required
Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 16 days ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 16 days ago