Recipients

List Recipients for a User

Changed on
<Note icon="fa-regular fa-circle-info"> **Note – Endpoint returns filtered list by default**

By default, this endpoint returns only recipients with the RecipientScope value of PAYOUT. Specify ALL to retrieve both PAYIN and PAYOUT recipients, or PAYIN to retrieve only pay-in recipients.

By default, results are sorted by CreationDate in descending order. </Note>

List recipients created for a UserId

get/v2.01/{ClientId}/users/{UserId}/recipients

Request

  • Base URL
    https://api.sandbox.mangopay.com
  • URL
    https://api.sandbox.mangopay.com/v2.01/{ClientId}/users/{UserId}/recipients
  • Auth
    HTTP bearer

Path parameters

ClientIdstring required

Platform's API account identifier, associated with the API key.

UserIdstring required

The unique identifier of the user.

Query parameters

pageinteger

Start value: 1

Default value: 1

Indicates the index of the page for the pagination.

per_pageinteger

Min. value: 1; max. value: 100

Default value: 10

Indicates the number of items returned for each page of the pagination.

Sortstring

Possible values: CreationDate:ASC, CreationDate:DESC

Default value: CreationDate:DESC

Indicates the direction in which to sort the list.

RecipientScopestring

Possible values: ALL, PAYOUT, PAYIN

Default value: PAYOUT

By default, this endpoint returns only recipients with the RecipientScope value of PAYOUT.

Specify ALL to retrieve both PAYIN and PAYOUT recipients, or PAYIN to retrieve only pay-in recipients.

Read more about recipient scopes in the guide.

Response

Success

Idstring

Max length: 128 characters (see data formats for details)

The unique identifier of the object.

CreationDateinteger

Unix timestamp (UTC) of the date and time the object was created.

DisplayNamestring nullable

Length: 1–50; cannot contain: &,'/ (pattern:^(?!.*[&,'/]).{1,50}$)

A user-friendly name to identify the account. This value cannot be changed once the recipient is created.

PayoutMethodTypestring

Returned values: InternationalBankTransfer, LocalBankTransfer

The payout method of the recipient:

  • LocalBankTransfer – The account can only receive the corresponding local Currency for the Country via the domestic payment rail (e.g. EUR via a SEPA local scheme to a SEPA country, GBP via FPS to a GB account, USD via ACH to a US account, etc). Payouts in non-local currencies return an error.
  • InternationalBankTransfer – The account can receive both non-local currencies via SWIFT and also local currency via domestic rails.
RecipientTypestring

Returned values: Individual, Business

The recipient type:

  • Individual – An account held by a natural person, requiring the IndividualRecipient property.
  • Business – An account held by a legal entity, requiring the BusinessRecipient property.
Currencystring

Possible values: AED, AUD, CAD, CHF, CNH, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, NOK, NZD, PLN, RON, SAR, SEK, SGD, TRY, USD, ZAR

The currency of the recipient.

Countrystring

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The destination country of the payout method.

UserIdstring

The unique identifier of the user.

Statusstring

Returned values: PENDING, CANCELED, ACTIVE, DEACTIVATED

The status of the recipient:

  • PENDING – For PAYOUT scope recipients, the user must complete SCA before the recipient can become ACTIVE. For PAYIN scope recipients, the recipient creation is in progress.
  • CANCELED – SCA was not successfully completed and the recipient creation request was canceled. To retry, create another recipient to retrieve another PendingUserAction.RedirectUrl. The CANCELED status does not apply if RecipientScope is PAYIN.
  • ACTIVE – Recipient creation was successful (including SCA if RecipientScope is PAYOUT) and the recipient is ready to be used for payouts.
  • DEACTIVATED – The recipient has been permanently deactivated and can no longer be used.
RecipientScopestring

Returned values: PAYIN, PAYOUT

The scope of the recipient:

  • PAYOUT – Usable for payouts and in pay-in use cases. A PAYOUT recipient can only be created by a user with the UserCategory OWNER and requires SCA.
  • PAYIN - Not usable for payouts but only usable for pay-in use cases, such as direct debit and refunds using payouts. A PAYIN recipient can be created by a user with the UserCategory PAYER or OWNER, and does not require SCA.

Both PAYIN and PAYOUT scopes can be created for either InternationalBankTransfer or LocalBankTransfer, and for either IndividualRecipient or BusinessRecipient, and for any Currency.

Changes

  • f44a59c76515Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e731ec4a85bRevision changes
    • info

      api operation id list_recipients_user removed and replaced with recipients_list_recipients_user