Update recipient

This endpoint is used to update information for an existing payout recipient.

Important

You can only update a recipient record if the request is accepted by the payout provider associated with the recipientId.

Note

For the payout provider Interchecks, if you pass a value for one of the recipientIdNumbers parameters when creating a new recipient, you cannot update any recipient information with this endpoint.

In the case that a value has been passed for the recipientIdNumbers and you are wanting to change information for an existing Interchecks recipient, contact Interchecks to update the recipient's information.

Try It

To use the Try It feature for this endpoint, you must use the credentials for your Sandbox API user.

Include at least a recipienId and recipient firstName and lastName.

Request parameters

  • recipientId
  • firstName
  • lastName
  • recipientIdNumbers
  • recipientIdNumbers.governmentId
  • recipientIdNumbers.passportId
  • recipientIdNumbers.employerId
  • recipientIdNumbers.driversLicenseId
  • providerId
  • recipientRef
  • email
  • userType
  • gender
  • birthDate
  • countryOfBirth
  • countryOfNationality
  • country
  • currency
  • addressType
  • addressLine1
  • addressLine2
  • city
  • region
  • postalCode
  • phoneNumber
  • phoneNumberCountry
  • mobileNumber
  • mobileNumberCountry

Response parameters

  • payoutAccountId
  • providerId
  • recipientId
  • recipientRef
  • email
  • firstName
  • lastName
  • providerType
  • providerRecipientRef
  • userType
  • addressLine1
  • addressLine2
  • city
  • region
  • postalCode
  • country
  • phoneNumber
  • mobileNumber
  • countryOfBirth
  • countryOfNationality
  • gender
  • birthDate
  • recipientRulesMetadata
  • recipientRulesMetadata.id
  • recipientRulesMetadata.recipientId
  • recipientRulesMetadata.metadata
  • recipientRulesMetadata.createdAt
  • recipientRulesMetadata.updatedAt
  • recipientIdNumbers
  • recipientIdNumbers.governmentId
  • recipientIdNumbers.passportId
  • recipientIdNumbers.employerId
  • recipientIdNumbers.driversLicenseId
  • createdAt
  • updatedAt
Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!