Permanently disable a Recipient
DEACTIVATED
The status of the recipient:DEACTIVATED
– Value to send to permanently disable the recipient so it can no longer be used. The Recipient must be ACTIVE
to be deactivated.200
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.&,'/
(pattern:^(?!.*[&,'/]).{1,50}$
)A user-friendly name to identify the account. This value cannot be changed once the recipient is created.InternationalBankTransfer
, LocalBankTransfer
The payout method of the recipient.InternationalBankTransfer
– A bank wire transfer sent via SWIFT, requiring the InternationalBankTransfer
property.LocalBankTransfer
– A bank wire transfer sent via local routes, requiring the LocalBankTransfer
property.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.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.PAYIN
, PAYOUT
Default value: 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. You need to use the returned PendingUserAction.RedirectUrl
value, adding your encoded returnUrl
as a query parameter, to redirect the user to the hosted SCA session so they can complete the necessary steps.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.PAYIN
and PAYOUT
scopes can be created for either InternationalBankTransfer
or LocalBankTransfer
, and for either IndividualRecipient
or BusinessRecipient
, and for any Currency
.^.{0,255}$
)Custom data that you can add to this object. This value cannot be changed once the recipient is created.RecipientType
is Individual
.PayoutMethodType
is InternationalBankTransfer
.null
).400 - Recipient not ACTIVE