Refresh a Beneficiary

Re-checks the Beneficiary’s review status. Use it if the Beneficiary looks stuck on pending. No request body.

POST /api/v2/payouts/beneficiaries/{id}/refresh

Refresh a Beneficiary

cURL

curl --request POST \
  --url https://api.mansa.xyz/api/v2/payouts/beneficiaries/{id}/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <api-key>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "beneficiary_type": "bank",
  "account_holder_name": "<string>",
  "account_number": "<string>",
  "status": "pending",
  "active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "bank_name": "<string>",
  "bank_swift": "<string>",
  "bank_country_code": "<string>",
  "bank_address": "<string>",
  "bank_province": "<string>",
  "bank_city": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "chain_type": "TRC20",
  "status_reason": "<string>",
  "subject_type": "corporate",
  "beneficiary_country_code": "<string>",
  "beneficiary_province": "<string>",
  "beneficiary_city": "<string>",
  "beneficiary_address": "<string>",
  "beneficiary_postcode": "<string>"
}

Authorizations

x-api-key · string · header · required

API key for authentication

Authorization · string · header · required

ES256 JWT signed by the private key registered to the API key above. Claims: sub (=API key), uri, nbf, iat, exp, and bodyHash (HMAC-SHA512 of uri + rawBody + nbf using a shared secret, base64).

Path Parameters

id · string<uuid> · required

ID of the Beneficiary

Response

200

application/json

The Beneficiary with its latest status

id · string<uuid> · required

beneficiary_type · enum<string> · required

Available options: bank, crypto, platform

account_holder_name · string · required

account_number · string · required

status · enum<string> · required

Starts pending. No client action moves it — resolves automatically once asynchronous partner KYC/KYB review completes.

Available options: pending, ready, rejected

active · boolean · required

created_at · string<date-time> · required

updated_at · string<date-time> · required

bank_name · string | null

Bank only

bank_swift · string | null

Bank only

bank_country_code · string | null

Bank only

bank_address · string | null

Bank only

bank_province · string | null

Bank only

bank_city · string | null

Bank only

first_name · string | null

last_name · string | null

chain_type · enum<string> | null

Crypto only

Available options: TRC20, ERC20, null

status_reason · string | null

Present only when status is rejected.

subject_type · enum<string> | null

Available options: corporate, individual, null

beneficiary_country_code · string | null

Bank only

beneficiary_province · string | null

Bank only

beneficiary_city · string | null

Bank only

beneficiary_address · string | null

Bank only

beneficiary_postcode · string | null

Bank only