Skip to content

Payout Links Asynchronous Endpoints

This Payout Links endpoint provides asynchronous methods to interact with the payout links of the authenticated user.

Example usage of the Payout links endpoint object:

import asyncio
from pyrevolut.client import AsyncClient

CREDS_JSON_LOC = "path/to/creds.json"

client = AsyncClient(
    creds_loc=CREDS_JSON_LOC,
    sandbox=True,
)

async def run():
    async with client:
        links = await client.PayoutLinks.get_all_payout_links()
        print(links)

asyncio.run(run())

EndpointPayoutLinksAsync

Bases: BaseEndpointAsync

The async Payout Links API

Use payout links to send money without having to request full banking details of the recipient. The recipient must claim the money before the link expires.

Source code in pyrevolut/api/payout_links/endpoint/asynchronous.py 
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
class EndpointPayoutLinksAsync(BaseEndpointAsync):
    """The async Payout Links API

    Use payout links to send money without having to request full
    banking details of the recipient.
    The recipient must claim the money before the link expires.
    """

    async def get_all_payout_links(
        self,
        state: EnumPayoutLinkState | None = None,
        created_before: datetime | DateTime | str | int | float | None = None,
        limit: int | None = None,
        **kwargs,
    ) -> list[dict] | list[RetrieveListOfPayoutLinks.Response]:
        """
        Get all the links that you have created, or use the query parameters to filter the results.

        The links are sorted by the created_at date in reverse chronological order.

        The returned links are paginated. The maximum number of payout links returned per
        page is specified by the limit parameter. To get to the next page, make a
        new request and use the created_at date of the last payout link returned in the previous response.

        Note
        ----
        This feature is available in the UK and the EEA.

        Parameters
        ----------
        state : EnumPayoutLinkState, optional
            The state that the payout link is in. Possible states are:

                created:
                    The payout link has been created, but the amount has not yet been blocked.
                failed:
                    The payout link couldn't be generated due to a failure during transaction booking.
                awaiting:
                    The payout link is awaiting approval.
                active:
                    The payout link can be redeemed.
                expired:
                    The payout link cannot be redeemed because it wasn't claimed before its expiry date.
                cancelled:
                    The payout link cannot be redeemed because it was cancelled.
                processing:
                    The payout link has been redeemed and is being processed.
                processed:
                    The payout link has been redeemed and the money has been transferred to the recipient.
        created_before : datetime | DateTime | str | int | float, optional
            Retrieves links with created_at < created_before.
            The default value is the current date and time at which you are calling the endpoint.

            Provided in ISO 8601 format.
        limit : int, optional
            The maximum number of links returned per page.
            To get to the next page, make a new request and use the
            created_at date of the last payout link returned in the previous
            response as the value for created_before.

            If not provided, the default value is 100.

        Returns
        -------
        list[dict] | list[RetrieveListOfPayoutLinks.Response]
            A list of payout links.
        """
        endpoint = RetrieveListOfPayoutLinks
        path = endpoint.ROUTE
        params = endpoint.Params(
            state=state,
            created_before=created_before,
            limit=limit,
        )

        return await self.client.get(
            path=path,
            response_model=endpoint.Response,
            params=params,
            **kwargs,
        )

    async def get_payout_link(
        self,
        payout_link_id: UUID,
        **kwargs,
    ) -> dict | RetrievePayoutLink.Response:
        """
        Get the information about a specific link by its ID.

        Note
        ----
        This feature is available in the UK and the EEA.

        Parameters
        ----------
        payout_link_id : UUID
            The ID of the payout link.

        Returns
        -------
        dict | RetrievePayoutLink.Response
            The payout link information.
        """
        endpoint = RetrievePayoutLink
        path = endpoint.ROUTE.format(payout_link_id=payout_link_id)
        params = endpoint.Params()

        return await self.client.get(
            path=path,
            response_model=endpoint.Response,
            params=params,
            **kwargs,
        )

    async def create_payout_link(
        self,
        counterparty_name: str,
        request_id: str,
        account_id: UUID,
        amount: float,
        currency: str,
        reference: str,
        payout_methods: list[EnumPayoutLinkPaymentMethod],
        save_counterparty: bool | None = None,
        expiry_period: Duration | str | None = None,
        transfer_reason_code: EnumTransferReasonCode | None = None,
        **kwargs,
    ) -> dict | CreatePayoutLink.Response:
        """
        Create a payout link to send money even when you don't have the full
        banking details of the counterparty.
        After you have created the link, send it to the recipient so that
        they can claim the payment.

        Note
        ----
        This feature is available in the UK and the EEA.

        Parameters
        ----------
        counterparty_name : str
            The name of the counterparty provided by the sender.
        request_id : str
            The ID of the request, provided by the sender.

            To ensure that a link payment is not processed multiple times if there
            are network or system errors, the same request_id should be used for
            requests related to the same link.
        account_id : UUID
            The ID of the sender's account.
        amount : float
            The amount of money to be sent.
        currency : str
            The currency of the amount to be sent.
        reference : str
            A reference for the payment.
        payout_methods : list[EnumPayoutLinkPaymentMethod]
            The payout methods that the recipient can use to claim the payment.
        save_counterparty : bool, optional
            Indicates whether to save the recipient as your counterparty upon link claim.
            If false then the counterparty will not show up on your counterparties list,
            for example, when you retrieve your counterparties.
            However, you will still be able to retrieve this counterparty by its ID.

            If you don't choose to save the counterparty on link creation, you can do it later
            from your transactions list in the Business app.

            If not provided, the default value is false.
        expiry_period : Duration | str, optional
            Possible values: >= P1D and <= P7D

            Default value: P7D

            The period after which the payout link expires if not claimed before,
            provided in ISO 8601 format.

            The default and maximum value is 7 days from the link creation.
        transfer_reason_code : EnumTransferReasonCode, optional
            The reason code for the transaction.
            Transactions to certain countries and currencies might require you to
            provide a transfer reason.
            You can check available reason codes with the getTransferReasons operation.

            If a transfer reason is not required for the given currency and country,
            this field is ignored.

        Returns
        -------
        dict | CreatePayoutLink.Response
            The payout link information.
        """
        endpoint = CreatePayoutLink
        path = endpoint.ROUTE
        body = endpoint.Body(
            counterparty_name=counterparty_name,
            save_counterparty=save_counterparty,
            request_id=request_id,
            account_id=account_id,
            amount=amount,
            currency=currency,
            reference=reference,
            payout_methods=payout_methods,
            expiry_period=expiry_period,
            transfer_reasion_code=transfer_reason_code,
        )

        return await self.client.post(
            path=path,
            response_model=endpoint.Response,
            body=body,
            **kwargs,
        )

    async def cancel_payout_link(
        self,
        payout_link_id: UUID,
        **kwargs,
    ) -> dict | CancelPayoutLink.Response:
        """
        Cancel a payout link.
        You can only cancel a link that hasn't been claimed yet.
        A successful request does not get any content in response.

        Note
        ----
        This feature is available in the UK and the EEA.

        Parameters
        ----------
        payout_link_id : UUID
            The ID of the payout link.

        Returns
        -------
        dict | CancelPayoutLink.Response
            An empty dictionary.
        """
        endpoint = CancelPayoutLink
        path = endpoint.ROUTE.format(payout_link_id=payout_link_id)
        body = endpoint.Body()

        return await self.client.post(
            path=path,
            response_model=endpoint.Response,
            body=body,
            **kwargs,
        )

Cancel a payout link. You can only cancel a link that hasn't been claimed yet. A successful request does not get any content in response.

Note

This feature is available in the UK and the EEA.

Parameters:

Name Type Description Default
payout_link_id UUID

The ID of the payout link.

 required

Returns:

Type Description
dict | Response

An empty dictionary.
Source code in pyrevolut/api/payout_links/endpoint/asynchronous.py 
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
async def cancel_payout_link(
    self,
    payout_link_id: UUID,
    **kwargs,
) -> dict | CancelPayoutLink.Response:
    """
    Cancel a payout link.
    You can only cancel a link that hasn't been claimed yet.
    A successful request does not get any content in response.

    Note
    ----
    This feature is available in the UK and the EEA.

    Parameters
    ----------
    payout_link_id : UUID
        The ID of the payout link.

    Returns
    -------
    dict | CancelPayoutLink.Response
        An empty dictionary.
    """
    endpoint = CancelPayoutLink
    path = endpoint.ROUTE.format(payout_link_id=payout_link_id)
    body = endpoint.Body()

    return await self.client.post(
        path=path,
        response_model=endpoint.Response,
        body=body,
        **kwargs,
    )

Create a payout link to send money even when you don't have the full banking details of the counterparty. After you have created the link, send it to the recipient so that they can claim the payment.

Note

This feature is available in the UK and the EEA.

Parameters:

Name Type Description Default
counterparty_name str

The name of the counterparty provided by the sender.

 required
request_id str

The ID of the request, provided by the sender.

To ensure that a link payment is not processed multiple times if there are network or system errors, the same request_id should be used for requests related to the same link.

 required
account_id UUID

The ID of the sender's account.

 required
amount float

The amount of money to be sent.

 required
currency str

The currency of the amount to be sent.

 required
reference str

A reference for the payment.

 required
payout_methods list[EnumPayoutLinkPaymentMethod]

The payout methods that the recipient can use to claim the payment.

 required
save_counterparty bool

Indicates whether to save the recipient as your counterparty upon link claim. If false then the counterparty will not show up on your counterparties list, for example, when you retrieve your counterparties. However, you will still be able to retrieve this counterparty by its ID.

If you don't choose to save the counterparty on link creation, you can do it later from your transactions list in the Business app.

If not provided, the default value is false.

 None
expiry_period Duration | str

Possible values: >= P1D and <= P7D

Default value: P7D

The period after which the payout link expires if not claimed before, provided in ISO 8601 format.

The default and maximum value is 7 days from the link creation.

 None
transfer_reason_code EnumTransferReasonCode

The reason code for the transaction. Transactions to certain countries and currencies might require you to provide a transfer reason. You can check available reason codes with the getTransferReasons operation.

If a transfer reason is not required for the given currency and country, this field is ignored.

 None

Returns:

Type Description
dict | Response

The payout link information.
Source code in pyrevolut/api/payout_links/endpoint/asynchronous.py 
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
async def create_payout_link(
    self,
    counterparty_name: str,
    request_id: str,
    account_id: UUID,
    amount: float,
    currency: str,
    reference: str,
    payout_methods: list[EnumPayoutLinkPaymentMethod],
    save_counterparty: bool | None = None,
    expiry_period: Duration | str | None = None,
    transfer_reason_code: EnumTransferReasonCode | None = None,
    **kwargs,
) -> dict | CreatePayoutLink.Response:
    """
    Create a payout link to send money even when you don't have the full
    banking details of the counterparty.
    After you have created the link, send it to the recipient so that
    they can claim the payment.

    Note
    ----
    This feature is available in the UK and the EEA.

    Parameters
    ----------
    counterparty_name : str
        The name of the counterparty provided by the sender.
    request_id : str
        The ID of the request, provided by the sender.

        To ensure that a link payment is not processed multiple times if there
        are network or system errors, the same request_id should be used for
        requests related to the same link.
    account_id : UUID
        The ID of the sender's account.
    amount : float
        The amount of money to be sent.
    currency : str
        The currency of the amount to be sent.
    reference : str
        A reference for the payment.
    payout_methods : list[EnumPayoutLinkPaymentMethod]
        The payout methods that the recipient can use to claim the payment.
    save_counterparty : bool, optional
        Indicates whether to save the recipient as your counterparty upon link claim.
        If false then the counterparty will not show up on your counterparties list,
        for example, when you retrieve your counterparties.
        However, you will still be able to retrieve this counterparty by its ID.

        If you don't choose to save the counterparty on link creation, you can do it later
        from your transactions list in the Business app.

        If not provided, the default value is false.
    expiry_period : Duration | str, optional
        Possible values: >= P1D and <= P7D

        Default value: P7D

        The period after which the payout link expires if not claimed before,
        provided in ISO 8601 format.

        The default and maximum value is 7 days from the link creation.
    transfer_reason_code : EnumTransferReasonCode, optional
        The reason code for the transaction.
        Transactions to certain countries and currencies might require you to
        provide a transfer reason.
        You can check available reason codes with the getTransferReasons operation.

        If a transfer reason is not required for the given currency and country,
        this field is ignored.

    Returns
    -------
    dict | CreatePayoutLink.Response
        The payout link information.
    """
    endpoint = CreatePayoutLink
    path = endpoint.ROUTE
    body = endpoint.Body(
        counterparty_name=counterparty_name,
        save_counterparty=save_counterparty,
        request_id=request_id,
        account_id=account_id,
        amount=amount,
        currency=currency,
        reference=reference,
        payout_methods=payout_methods,
        expiry_period=expiry_period,
        transfer_reasion_code=transfer_reason_code,
    )

    return await self.client.post(
        path=path,
        response_model=endpoint.Response,
        body=body,
        **kwargs,
    )

Get all the links that you have created, or use the query parameters to filter the results.

The links are sorted by the created_at date in reverse chronological order.

The returned links are paginated. The maximum number of payout links returned per page is specified by the limit parameter. To get to the next page, make a new request and use the created_at date of the last payout link returned in the previous response.

Note

This feature is available in the UK and the EEA.

Parameters:

Name Type Description Default
state EnumPayoutLinkState

The state that the payout link is in. Possible states are:

created:
    The payout link has been created, but the amount has not yet been blocked.
failed:
    The payout link couldn't be generated due to a failure during transaction booking.
awaiting:
    The payout link is awaiting approval.
active:
    The payout link can be redeemed.
expired:
    The payout link cannot be redeemed because it wasn't claimed before its expiry date.
cancelled:
    The payout link cannot be redeemed because it was cancelled.
processing:
    The payout link has been redeemed and is being processed.
processed:
    The payout link has been redeemed and the money has been transferred to the recipient.
None
created_before datetime | DateTime | str | int | float

Retrieves links with created_at < created_before. The default value is the current date and time at which you are calling the endpoint.

Provided in ISO 8601 format.

 None
limit int

The maximum number of links returned per page. To get to the next page, make a new request and use the created_at date of the last payout link returned in the previous response as the value for created_before.

If not provided, the default value is 100.

 None

Returns:

Type Description
list[dict] | list[Response]

A list of payout links.
Source code in pyrevolut/api/payout_links/endpoint/asynchronous.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
async def get_all_payout_links(
    self,
    state: EnumPayoutLinkState | None = None,
    created_before: datetime | DateTime | str | int | float | None = None,
    limit: int | None = None,
    **kwargs,
) -> list[dict] | list[RetrieveListOfPayoutLinks.Response]:
    """
    Get all the links that you have created, or use the query parameters to filter the results.

    The links are sorted by the created_at date in reverse chronological order.

    The returned links are paginated. The maximum number of payout links returned per
    page is specified by the limit parameter. To get to the next page, make a
    new request and use the created_at date of the last payout link returned in the previous response.

    Note
    ----
    This feature is available in the UK and the EEA.

    Parameters
    ----------
    state : EnumPayoutLinkState, optional
        The state that the payout link is in. Possible states are:

            created:
                The payout link has been created, but the amount has not yet been blocked.
            failed:
                The payout link couldn't be generated due to a failure during transaction booking.
            awaiting:
                The payout link is awaiting approval.
            active:
                The payout link can be redeemed.
            expired:
                The payout link cannot be redeemed because it wasn't claimed before its expiry date.
            cancelled:
                The payout link cannot be redeemed because it was cancelled.
            processing:
                The payout link has been redeemed and is being processed.
            processed:
                The payout link has been redeemed and the money has been transferred to the recipient.
    created_before : datetime | DateTime | str | int | float, optional
        Retrieves links with created_at < created_before.
        The default value is the current date and time at which you are calling the endpoint.

        Provided in ISO 8601 format.
    limit : int, optional
        The maximum number of links returned per page.
        To get to the next page, make a new request and use the
        created_at date of the last payout link returned in the previous
        response as the value for created_before.

        If not provided, the default value is 100.

    Returns
    -------
    list[dict] | list[RetrieveListOfPayoutLinks.Response]
        A list of payout links.
    """
    endpoint = RetrieveListOfPayoutLinks
    path = endpoint.ROUTE
    params = endpoint.Params(
        state=state,
        created_before=created_before,
        limit=limit,
    )

    return await self.client.get(
        path=path,
        response_model=endpoint.Response,
        params=params,
        **kwargs,
    )

Get the information about a specific link by its ID.

Note

This feature is available in the UK and the EEA.

Parameters:

Name Type Description Default
payout_link_id UUID

The ID of the payout link.

 required

Returns:

Type Description
dict | Response

The payout link information.
Source code in pyrevolut/api/payout_links/endpoint/asynchronous.py 
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
async def get_payout_link(
    self,
    payout_link_id: UUID,
    **kwargs,
) -> dict | RetrievePayoutLink.Response:
    """
    Get the information about a specific link by its ID.

    Note
    ----
    This feature is available in the UK and the EEA.

    Parameters
    ----------
    payout_link_id : UUID
        The ID of the payout link.

    Returns
    -------
    dict | RetrievePayoutLink.Response
        The payout link information.
    """
    endpoint = RetrievePayoutLink
    path = endpoint.ROUTE.format(payout_link_id=payout_link_id)
    params = endpoint.Params()

    return await self.client.get(
        path=path,
        response_model=endpoint.Response,
        params=params,
        **kwargs,
    )