Payee

The Payee API returns the Payee details.

Payee Endpoints

get/v1/banking/payees

The Payee model

Retrieve payee object.

Attributes

Expand all
payees
arrayrequired

A list of Payees for the given end user

Show child attributes
Show child attributes
Response
{
    "payees": [
        {
            "arrangement_id": "70c90432-e8f4-40e0-b1a6-4f2b52a439a7",
            "biller": {
                "biller_code": "123456",
                "biller_name": "Electricity Co.",
                "crn": "987654321"
            },
            "creation_date": "2023-09-10",
            "description": "Monthly rent payment",
            "digital_wallet": {
                "identifier": "user@example.com",
                "name": "John Doe",
                "provider": "PAYPAL_AU",
                "type": "EMAIL"
            },
            "domestic": {
                "account": {
                    "account_name": "John Doe",
                    "account_number": "12345678",
                    "bsb": "062000"
                },
                "card": {
                    "card_number": "4111111111111111"
                },
                "pay_id": {
                    "identifier": "user@example.com",
                    "name": "John Doe",
                    "type": "EMAIL"
                },
                "payee_account_u_type": "account"
            },
            "fiskil_id": "bank_payee_abcdef",
            "institution_id": "2",
            "international": {
                "bank_details": {
                    "account_number": "1234567890",
                    "bank_address": {
                        "address": "123 Bank St",
                        "name": "Bank of America"
                    },
                    "beneficiary_bank_bic": "BOFAUS3N",
                    "chip_number": "987654321",
                    "country": "USA",
                    "fed_wire_number": "123456789",
                    "legal_entity_identifier": "5493001KJTIIGC8Y1R12",
                    "routing_number": "021000021",
                    "sort_code": "404040"
                },
                "beneficiary_details": {
                    "country": "USA",
                    "message": "Payment for invoice #12345",
                    "name": "Jane Doe"
                }
            },
            "nickname": "Flatmate",
            "payee_id": "payee-123",
            "payee_u_type": "domestic",
            "type": "DOMESTIC"
        }
    ],
    "links": {
        "next": "https://api.fiskil.com/v1/accounts?page[after]=x",
        "prev": "https://api.fiskil.com/v1/accounts?page[before]=x"
    }
}
GET

/v1/banking/payees

Get All Payees

Returns a list of all payees.

Parameters

end_user_idstringrequired

A unique identifier for the End User object.

page[before]string

When the page[before] is specified, backwards pagination is achieved

page[after]string

When the page[after] is specified, forwards pagination is achieved

page[size]integer

When the page[size] is specified, no more than page[size] resources will be included in the response's data field. This parameter is set to a sensible default, which varies depending on the endpoint.

Request
GET/v1/banking/payees
curl --request GET \
     --url https://api.fiskil.com/v1/v1/banking/payees?end_user_id={end_user_id}&page[before]={page[before]}&page[after]={page[after]}&page[size]={page[size]} \
     --header 'Authorization: Bearer {access_token}' \
     --header 'accept: application/json; charset=UTF-8' \
     --header 'content-type: application/json; charset=UTF-8' 
Response
{
    "payees": [
        {
            "arrangement_id": "70c90432-e8f4-40e0-b1a6-4f2b52a439a7",
            "biller": {
                "biller_code": "123456",
                "biller_name": "Electricity Co.",
                "crn": "987654321"
            },
            "creation_date": "2023-09-10",
            "description": "Monthly rent payment",
            "digital_wallet": {
                "identifier": "user@example.com",
                "name": "John Doe",
                "provider": "PAYPAL_AU",
                "type": "EMAIL"
            },
            "domestic": {
                "account": {
                    "account_name": "John Doe",
                    "account_number": "12345678",
                    "bsb": "062000"
                },
                "card": {
                    "card_number": "4111111111111111"
                },
                "pay_id": {
                    "identifier": "user@example.com",
                    "name": "John Doe",
                    "type": "EMAIL"
                },
                "payee_account_u_type": "account"
            },
            "fiskil_id": "bank_payee_abcdef",
            "institution_id": "2",
            "international": {
                "bank_details": {
                    "account_number": "1234567890",
                    "bank_address": {
                        "address": "123 Bank St",
                        "name": "Bank of America"
                    },
                    "beneficiary_bank_bic": "BOFAUS3N",
                    "chip_number": "987654321",
                    "country": "USA",
                    "fed_wire_number": "123456789",
                    "legal_entity_identifier": "5493001KJTIIGC8Y1R12",
                    "routing_number": "021000021",
                    "sort_code": "404040"
                },
                "beneficiary_details": {
                    "country": "USA",
                    "message": "Payment for invoice #12345",
                    "name": "Jane Doe"
                }
            },
            "nickname": "Flatmate",
            "payee_id": "payee-123",
            "payee_u_type": "domestic",
            "type": "DOMESTIC"
        }
    ],
    "links": {
        "next": "https://api.fiskil.com/v1/accounts?page[after]=x",
        "prev": "https://api.fiskil.com/v1/accounts?page[before]=x"
    }
}

Was this page helpful?