Validate Beneficiary Details

Endpoint Description

This endpoint allows you to update the confirmation status of a specific beneficiary associated with a user account. By sending a PUT request to the specified URL, you can confirm or modify the beneficiary’s status as needed.

Request

Method: POST
URL: /v1/accounts/:accountId/beneficiaries/:beneficiaryId
Path Parameters :
accountId - The unique identifier of the account (e.g., 36abacac-2aa2-4eb7-b96e-870364065c05)
beneficiaryId - The unique identifier of the beneficiaryId (e.g., 7188121ac-2aa2-4eb7-b96e-870364065c05)
Authentication: Requires authentication.

Request Body

{
  "confirmed": true
}

Response

Status Code: 200 OK
Content-Type: application/json

Response Body

Response Description: On a successful request, the server responds with a status code of 200 and a JSON object containing the following structure:

• success: A boolean indicating the success of the request.
• data: An object containing quote details:
  • orderId: A unique identifier for the order.
  • quoteRequestId: A unique identifier for the quote request.
  • from: An object representing the source currency details:
    • amount: The amount in the source currency.
    • currency: The ISO currency code of the source (e.g., “GBP”).
  • to: An object representing the target currency details:
    • amount: The amount in the target currency.
    • currency: The ISO currency code of the target (e.g., “EUR”).
  • exchangeRate: The exchange rate applied for the conversion.
  • inverseExchangeRate: The inverse of the exchange rate.
  • settlementDate: The date of settlement.
  • fee: Any associated fee (can be 0).
  • expiresAt: The timestamp when the quote expires.