Recipients
List Recipients for a User
Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- User data format
- KYC documents
- UBO declarations
Wallets
- User wallets
- Client wallets
Cards
- Card registrations
- Cards
- Metadata
- Card validations
Card pay-ins
- Direct card pay-ins
- Recurring card pay-ins
- Preauthorizations
- Deposit preauthorizations
- Web card pay-ins
Banking pay-ins
- Bank wires
- Pay by bank
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- BLIK
- Giropay
- Google Pay
- iDEAL
- Klarna
- MB WAY
- Multibanco
- Payconiq
- PayPal
- Satispay
- Swish
- TWINT
Transfers
- Transfers
Refunds
- Refunds
Disputes
- Disputes
- Dispute documents
- Repudiations
- Dispute settlement
Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
Recipients
List Recipients for a User
List recipients created for a UserId
GET
/
v2.01
/
{ClientId}
/
users
/
{UserId}
/
recipients
[
{
"Id": "rec_01JRADY1QCNHS6821GZJRVM1MV",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYCRSFG4J19C36AD893SF",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYFJYPFM10XPQ8VFWW947",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "ACTIVE",
"RecipientScope": "PAYOUT"
}
]
Path parameters
The unique identifier of the user.
Responses
The list of recipients created for the user.
The unique identifier of the object.
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.
Possible values: InternationalBankTransfer, LocalBankTransfer
The payout method of the recipient.
InternationalBankTransfer– A bank wire transfer sent via SWIFT, requiring theInternationalBankTransferproperty.LocalBankTransfer– A bank wire transfer sent via local routes, requiring theLocalBankTransferproperty.
Possible values: Individual, Business
The recipient type:
Individual– An account held by a natural person, requiring theIndividualRecipientproperty.Business– An account held by a legal entity, requiring theBusinessRecipientproperty.
Possible values: AUD, CAD, EUR, GBP, HKD, SGD, USD
The currency of the recipient.
The unique identifier of the user.
Possible values: PENDING, CANCELED, ACTIVE, DEACTIVATED
The status of the recipient:
PENDING– ForPAYOUTscope recipients, the user must complete SCA before the recipient can becomeACTIVE. ForPAYINscope 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 anotherPendingUserAction.RedirectUrl. TheCANCELEDstatus does not apply ifRecipientScopeisPAYIN.ACTIVE– Recipient creation was successful (including SCA ifRecipientScopeisPAYOUT) and the recipient is ready to be used for payouts .DEACTIVATED– The recipient has been permanently deactivated and can no longer be used.
Possible values: PAYIN, PAYOUT
Default value: PAYOUT
The scope of the recipient:
PAYOUT– Usable for payouts and in pay-in use cases. APAYOUTrecipient can only be created by a user with theUserCategoryOWNERand requires SCA. You need to use the returnedPendingUserAction.RedirectUrlvalue, adding your encodedreturnUrlas a query parameter, to redirect the user to the hosted SCA session so they can complete the necessary steps.PAYIN- Usable for pay-in use cases only, such as direct debit and refunds using payouts. APAYINrecipient can be created by a user with theUserCategoryPAYERorOWNER, 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.
[
{
"Id": "rec_01JRADY1QCNHS6821GZJRVM1MV",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYCRSFG4J19C36AD893SF",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYFJYPFM10XPQ8VFWW947",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "ACTIVE",
"RecipientScope": "PAYOUT"
}
]
Was this page helpful?
[
{
"Id": "rec_01JRADY1QCNHS6821GZJRVM1MV",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYCRSFG4J19C36AD893SF",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "PENDING",
"RecipientScope": "PAYOUT"
},
{
"Id": "rec_01JRADYFJYPFM10XPQ8VFWW947",
"DisplayName": "Alex Smith EUR international payout account",
"PayoutMethodType": "InternationalBankTransfer",
"RecipientType": "Business",
"Currency": "EUR",
"UserId": "user_m_01JRADX7YD0060N5VAA0XPMM54",
"Status": "ACTIVE",
"RecipientScope": "PAYOUT"
}
]