Pay InRouting funds

Route funds from a transaction

Route funds from transactions to different bank accounts for a single paypoint
Applies to:Developers

Payabli allows you to route funds from a transaction to a specific bank account for the paypoint. This option only works with a single paypoint that’s running the transaction, and can’t be used to distribute funds to accounts that belong to other paypoints.

Setup

Contact the Payabli team to enable and configure fund routing. After a paypoint is boarded, the Payabli team configures the merchant’s bank accounts. Payabli can add as many separate accounts as you need, and each account has an accountId.

Retrieve accountId

You can retrieve accountId values for all a Paypoint’s accounts by sending a GET request to the /Paypoint endpoint. They’re returned in objects in the Credentials array.

In this example, there are two accounts for ACH (187-782 and 187-783) and two accounts for card (187-798 and 187-799)

1{
2    "isSuccess": true,
3    "responseText": "Success",
4    "responseCode": 1,
5    "": {
6        "Paypoint": {
7            "IdPaypoint": 187,
8            "DbaName": "The Board Haus",
9            "LegalName": "Board Haus LLC.",
10            "Address1": "1801 Main Avenue",
11            "Address2": "",
12            "City": "Durango",
13            "Zip": "81301",
14            "ServiceData": null,
15        // Example truncated
16            "Credentials": [
17                {
18                    "Service": "ach",
19                    "Mode": 1,
20                    "Minticket": 0.0,
21                    "Maxticket": 100000.0,
22                    "CfeeFix": 0.0,
23                    "CfeeFloat": 0.0,
24                    "CfeeMin": 0.0,
25                    "CfeeMax": 0.0,
26                    "ReferenceId": 348,
27                    "AccountId": "187-782"
28                },
29                {
30                    "Service": "ach",
31                    "Mode": 0,
32                    "Minticket": 0.0,
33                    "Maxticket": 100000.0,
34                    "CfeeFix": 0.0,
35                    "CfeeFloat": 0.0,
36                    "CfeeMin": 0.0,
37                    "CfeeMax": 0.0,
38                    "ReferenceId": 348,
39                    "AccountId": "187-783"
40                },
41                {
42                    "Service": "card",
43                    "Mode": 0,
44                    "Minticket": 0.0,
45                    "Maxticket": 100000.0,
46                    "CfeeFix": 0.0,
47                    "CfeeFloat": 0.0,
48                    "CfeeMin": 0.0,
49                    "CfeeMax": 0.0,
50                    "ReferenceId": 358,
51                    "AccountId": "187-798"
52                },
53                {
54                    "Service": "card",
55                    "Mode": 1,
56                    "Minticket": 0.0,
57                    "Maxticket": 100000.0,
58                    "CfeeFix": 0.0,
59                    "CfeeFloat": 0.0,
60                    "CfeeMin": 0.0,
61                    "CfeeMax": 0.0,
62                    "ReferenceId": 358,
63                    "AccountId": "187-799"
64                },
65    
66                // Example truncated
67            ]
68        },
69    },
70}

Routing transactions

When there is more than one account set up for a payment method, you must pass an accountId with the transaction. For example, if you have Account A and Account B set up for card transactions, each transaction must include an accountId for either Account A or Account B.

In these examples, Account A has an accountId of 187-798, and Account B has an accountId of 187-799.

$curl --request POST \
>     --url 'https://api-sandbox.payabli.com/api/MoneyIn/getpaid?forceCustomerCreation=false' \
>     --header 'accept: application/json' \
>     --header 'content-type: application/*+json' \
>     --header 'requestToken: API TOKEN'
>{
>    "entryPoint": "41035afaa7",
>    "paymentMethod": {
>        "method": "card",
>        "cardnumber": "4293189100000008",
>        "cardexp": "0924",
>        "cardcvv": "345",
>        "cardzip": "34234",
>        "cardHolder": "John Smith"
>    },
>    "paymentDetails": {
>        "totalAmount":20,
>        "serviceFee": 0.00
>    },
>    "customerData": {
>        "customerId": 224,
>        "customerNumber": "888",
>        "billingAddress1": "5127 Linkwood ave"
>        },
>     "accountId": "187-798"

If a paypoint is set up with multiple accounts and you don’t include an accountId with a transaction, you’ll get a “Multiple Gateway Data for payment method” error:

Example error response
1{
2    "responseText": "Declined",
3    "isSuccess": false,
4    "responseData": {
5        "authCode": null,
6        "referenceId": null,
7        "resultCode": 3,
8        "resultText": "Multiple Gateway Data for payment method",
9        "avsResponseText": null,
10        "cvvResponseText": null,
11        "customerId": null,
12        "methodReferenceId": null
13    }
14}