elinx

This endpoint is used to create an eLinx request. Once the eLinx request is created successfully, the request link will be sent through an email to the recipient.

Notes:

  • If you do not wish to send an eLinx request via an email, sms or whatsapp, then simply set SendNotification = false

  • Before sending an eLinx request, you must set your default email address using the /elinx/setup-sender-email endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data
string
required

Your account ID

string
required

API key for the account

string
required

Hashed signature for the request

string

Client Account ID

string
required

Sender's full name. This is the name of the person who is sending the eLinx request to the recipient.

string
required

Receiver's full name. This is the name of the person receiving the eLinx request.

string

Only required if you are requesting banking info for the purposes of a payment. Valid options are fund or withdraw. Choose fund if you are sending an eLinx request to collect money, and withdraw if you sending an eLinx request to send money.

string

Determines the payment rail to use for transactions involving banking rails. Possible values: eft, vopayinstant, ach, rtp, fednow, fedwire

number

The amount of the payment you are requesting in the eLinx. If an amount is specified, a transaction will be created once the eLinx request is fulfilled by the recipient.

integer

The ID of an in-flight funding transaction that will fund this withdraw request. Only valid for a non-scheduled withdraw request with an Amount. The eLinx request is created in the waiting status and the link is sent to the recipient once the funding transaction settles. The funding transaction must belong to your account, be a funding type, and must cover the Amount.

string

Only required if you are requesting banking info for a scheduled/recurring payment. Valid options are single or recurring.

string

Name of frequency of the scheduled transaction (Only for recurring option), the posibles values are: daily, weekdays, weekly, bi-weekly (biweekly is also accepted as an alias, but is stored and echoed back exactly as submitted - it is only normalized to bi-weekly internally when the schedule is generated at acceptance), semi-monthly, monthly, quarterly, semi-annually, annually. Values are matched case-insensitively. Any other value is rejected with a 400 - custom is no longer accepted, as it was never schedulable and produced a schedule with zero occurrences. Required if you are sending an eLinx request for a recurring payment.

integer
1 to 365
Defaults to 1

How many units to advance per period. For example, NameOfFrequency=weekly with Interval=2 fires every other week. Must be a whole number from 1 to 365. Only applies to daily, weekly, monthly, and annually — for bi-weekly, semi-monthly, quarterly, semi-annually, and weekdays the interval is fixed and this value is ignored. Interval never affects the first payment date. Defaults to 1 when omitted. Can only be provided when Frequency is recurring.

string

Pins payments to specific weekdays. Only applies to NameOfFrequency weekly or monthly. For weekly, provide one weekday abbreviation or a comma-separated list of them — MO, TU, WE, TH, FR, SA, SU (e.g. FR, or MO,WE,FR); each weekday may appear at most once. For monthly, provide exactly one value with a mandatory ordinal prefix, 1–4 or -1 for last (e.g. 1MO, 3FR, -1FR); comma-separated lists are not accepted for monthly. Input is case-insensitive; for weekly, whitespace around each entry is ignored, but a monthly value must have no surrounding whitespace. The stored value is canonicalized — uppercased and, for weekly, re-ordered into calendar order starting Monday — so ByDay=FR,MO is stored as MO,FR. A weekday repeated within one value is rejected rather than de-duplicated. Weeks run Monday to Sunday: the first payment is the earliest selected weekday on or after ScheduleStartDate, so a schedule starting on a Thursday with ByDay=MO,WE,FR fires only on the Friday of its first week. Can only be provided when Frequency is recurring.

string

Date from which the schedule will be started in YYYY-MM-DD format. Required if you are sending an eLinx for a recurring/scheduled payment.

string

Date when the transaction processing will end (Only for recurring option). Either provide ScheduleEndDate or EndingAfterPayments. One is required if you are sending an eLinx for a recurring payment.

integer

Number of payments after which the transaction processing will end (Only for recurring option). Either provide ScheduleEndDate or EndingAfterPayments. One is required if you are sending an eLinx for a recurring payment.

integer

Type of semi-monthly frequency. This field is only required when NameOfFrequency is set to semi-monthly. The possible values are: SemiMonthFirstAndFifteenth, SemiMonthFifteenthAndLast.

string

Invoice number of the payment

integer

ID of the document you want to include in the eLinx email. You must first upload a document using the POST /document endpoint, and then pass in the resulting DocumentID into this endpoint.

string

An optional reference number which was associated with the eLinx request.

string

An optional note to associate with the transaction.

boolean

This option is used to send an eLinx through email, sms, or whatsapp which later on can be used by a recipient to make the payment. A valid ReceiverPhoneNumber or ReceiverEmailAddress must be provided

string

Use this optional parameter to override the account-level setting for the eLinx delivery method. If not provided, the account-level setting will be used. Possible values: email, sms, whatsapp.

string

Customer's email address - Must be a valid email. Only required if SendNotification is true and NotificationMethod = email.

string

Customer's phone number - Must be a valid number. Only required if SendNotification is true and NotificationMethod = sms or whatsapp.

string

An iFrame key generated from /iq11/generate-embed-url. If provided, the settings applied to this iFrame will be used when the customer provides their bank account information. If not provided, the default iFrame settings will be used.

string

This will inform the end user of the flexible payment options that they can choose from. Input can be a comma-delimited list. The possible values are: multiple, partial, installments.

number

This is the minimum amount that can be accepted for a 'partial' payment option. Example, if total eLinx amount is 100.00, and MinimumPaymentAccepted is 25.00, the user will be able to choose a partial payment of 25.00 (or more). This is required if 'partial' is included in FlexiblePaymentOptions.

string

This will specify the date the remainder of the total amount should be paid if 'partial' payment is selected. This is optional if 'partial' is included in FlexiblePaymentOptions.

integer
2 to 1601

This will specify the number of installments that the payments will be split into. This is required if 'installments' is included in FlexiblePaymentOptions. Must be a whole number from 2 to 1601.

string

This will specify the frequency of installments. This is required if 'installments' is included in FlexiblePaymentOptions. The possible values are: weekly, biweekly, monthly.

boolean

Use this optional parameter to override the account-level setting for sending reminders to recipient. If not provided, the account-level setting will be used.

integer

Use this optional parameter to override the account-level setting for the eLinx reminder frequency (in days). If not provided, the account-level setting will be used.

string

Use this optional parameter to provide a message to the recipient.

string

This optional parameter can be added to ensure that the recipient is using an existing payment method, adding a new payment method or whether the client has access to both. Valid options include - New, Existing or Both. Defaults to New.

boolean

This optional parameter can be added to configure when to send an OTP for eLinx. By default OTP will be sent for existing payment methods only.

string

An optional GL code to associate with the transaction created from this eLinx request.

string

An optional transaction type code to associate with the transaction created from this eLinx request.

Response

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