Skip to main content

Search

How can we help?

Create a PayByLink Payment via the Judopay Portal.

From the Judopay Portal you can:

To create a new PayByLink payment:

pay by link payment

 
Step Description
1 From the side menu, select PayByLink.
2

All existing PayByLink transactions for your account are displayed by the judoId used to create the payment link. 

Displaying:

  • Your Payment Reference
  • Expiry Date
  • Amount
  • Status

Click the Create Link button.
3

The Create a Link form appears. 

Enter the following details:

  • Location Required.
    If you have access to more than one judoId, you will see a Location drop down list made up of the JudoId + truncated Trading Name. 
    Select the location based on the JudoId. 
    From the selected JudoId, the form will automatically update: 

    • Currency depending on enabled ECOM routes. 

    • Extra fields if MCC = 6012 / 6051 / 7299.

  • Consumer Reference Required. 
    A unique reference to anonymously identify the consumer.

  • Payment Reference Required. 
    Your reference for this PayByLink transaction. 
    This value should be unique in order to protect your consumers against duplicate transactions.

  • Consumer Name Optional. 
    The name of the consumer for whom you are creating the PayByLink transaction.

  • Consumer Email Optional. 
    The email address of the consumer for whom you are creating the PayByLink transaction.

  • Amount Required. 
    The amount to process. 
    Format: Two decimal places. 
    If you are looking to process currencies that use a different structure than two decimal places, please contact Judopay for support.

  • Currency Required. 
    Identifies the currency of the transaction. 
    Please contact Judopay if you need additional currencies for your transaction.

  • Expiry Date Required. 
    The expiry date of the PayByLink payment. 
    Format: DD/MM/YYYY 
    Must be in the future, and within a year.
4 Click the Create button.
5 The Success screen appears.
6

Click on either the:

  • Copy the link to the clipboard: The link can now be shared with the consumer. 
  • Download QR Code: Add the QR code to any printed materials. 
    The code will link to the payment link.

 

The Account Funding Information section is displayed only for merchants configured with supported MCCs. 
For more information, see Applicable Merchants.

If your account is not configured for AFT, this section will not appear and the PaybyLink flow remains unchanged.

 

AFT_PBL.png

 

Step Description
1 From the side menu, select PayByLink.
2

All existing PayByLink transactions for your account are displayed by the judoId used to create the payment link. 

Displaying:

  • Your Payment Reference
  • Expiry Date
  • Amount
  • Status

Click the Create Link button.
3

The Create a Link form appears. 

The AFT Recipient Information Section is also displayed for merchants configured with supported MCCs.
Enter the following details:

  • Location Required.
    If you have access to more than one judoId, you will see a Location drop down list made up of the JudoId + truncated Trading Name. 
    Select the location based on the JudoId. 
    From the selected JudoId, the form will automatically update: 

    • Currency depending on enabled ECOM routes. 

    • Extra fields if MCC = 6012 / 6051 / 7299.

  • Consumer Reference Required. 
    A unique reference to anonymously identify the consumer.

  • Payment Reference Required. 
    Your reference for this PayByLink transaction. 
    This value should be unique in order to protect your consumers against duplicate transactions.

  • Consumer Name Optional. 
    The name of the consumer for whom you are creating the PayByLink transaction.

  • Consumer Email Optional. 
    The email address of the consumer for whom you are creating the PayByLink transaction.

  • Amount Required. 
    The amount to process. 
    Format: Two decimal places. 
    If you are looking to process currencies that use a different structure than two decimal places, please contact Judopay for support.

  • Currency Required. 
    Identifies the currency of the transaction. 
    Please contact Judopay if you need additional currencies for your transaction.

  • Expiry Date Required. 
    The expiry date of the PayByLink payment. 
    Format: DD/MM/YYYY 
    Must be in the future, and within a year.
4

AFT Recipient Information Section. 

Enter the following details:

  • First Name Recipient's first name.

  • Address Line 1 Recipient's address.
  • Country Code Recipient's country 
    Format: ISO alpha-2.
  • State Required only for US & Canada
  • Account ID Recipient's account identifier.
  • Business Application ID Indicates the purpose of the transaction. 
    Select from the following values:
    • AA – Account to account
    • FD – Funds disbursement
    • FT – Funds transfer
    • PD – Payroll
    • TU – Top up
    • WT – Digital wallet
  • Account Type Indicates the recipient's account type. 
    Select from the following values:
    • 00 - Other
    • 01 - TRN & BAN
    • 02 - IBAN
    • 03 - Card (first6 & last4)
    • 06 - BAN & BIC (SWIFT code)
5 Click the Create button.
6

The Success screen appears.

Click on either the:

  • Copy the link to the clipboard: The link can now be shared with the consumer. 
    The consumer will firstly be directed to the new Billing Information screen required for the additional recipient information, and lastly the payment screen, to enter their card details.
  • Download QR Code: Add the QR code to any printed materials. 
    The code will link to the payment link.

 

If you are unsure which Business Application ID or Account Type values should be used for your transaction, contact your acquirer.

Validation Rules

For any missing or invalid information inline validation messages will be displayed. If only partial AFT fields have been populated, validation rules will prevent the creation of the payment link.

If none of the AFT fields are completed, the PaybyLink flow remains unchanged.

If any AFT field is populated:

  • All required AFT fields must also be completed.
  • Partial AFT field submissions are not supported.
  • Business Application ID and Account Type must be valid supported values.
  • Some Business Application ID and Account Type combinations may not be allowed. 
    Your acquirer is responsible for confirming the appropriate configuration for your transaction scenarios.

Partial submissions are not allowed.

Related to