> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Retry biometrics/acceptance for one person

POST https://tenant.api.corpx.com/v1/accreditations/{accreditationId}/persons/{cpf}/retry

Regenerates the facial-biometrics link (default flow), the acceptance
link (external biometrics flow) or the authorization link (`PENDING_CONSENT`, CPF that
already has an account) for one person of the accreditation — use it
when the link expired or the capture failed. The new link is also
delivered via the `accreditation.biometry.link.created` /
`accreditation.acceptance.link.created` /
`accreditation.consent.link.created` webhooks. **BaaS integrators only.**


Reference: https://docs.api.corpx.com/baas/referencia/accreditations/retry-accreditation-person

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `accreditationId` (string, required) — Accreditation (onboarding) identifier returned on creation.
- `cpf` (string, required) — CPF of the person (11 digits).

### Headers

- `X-Tenant-Id` (string, required) — Tenant context used for authorization and routing.
- `Idempotency-Key` (string, optional) — Optional client-generated idempotency token (recommended for safe retries).

## Response

### 202

Retry accepted; the person snapshot reflects the new link when already available.

- `accreditationId` (string, optional)
- `status` (enum, optional)
  - Allowed values: `retrying`
- `person` (AccreditationPersonView, optional) — Per-person biometrics/acceptance progress.

## Errors

### 404 Not Found Error

Accreditation or person not found.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

### 409 Conflict Error

Person biometrics already approved.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

### 500 Internal Server Error

Unexpected server error.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

## Types

### AccreditationPersonView

Per-person biometrics/acceptance progress.

- `personId` (string, optional) — Stable identifier of this person inside the accreditation. It is the value returned in the `personId` parameter of the `callbackUri` redirect — the CPF is never placed in a URI that ends up in browser history and proxy logs.
- `cpf` (string, optional)
- `name` (string, optional)
- `biometryStatus` (enum, optional)
  - Allowed values: `PENDING`, `APPROVED`, `FAILED`, `EXPIRED`
- `biometryLink` (string, optional) — Facial capture link (default Unico flow). May be absent right after creation — it is delivered via the `accreditation.biometry.link.created` webhook as soon as it is issued.
- `acceptanceStatus` (string, optional) — External biometrics flow only (PENDING, ACCEPTED, DENIED).
- `acceptanceLink` (string, optional) — Terms acceptance page URL (external biometrics flow only). Built from the stored token; may be absent right after creation — also delivered via `accreditation.acceptance.link.created`.
- `consentStatus` (enum, optional) — Present only when the CPF already has an account and the tenant has automatic portability enabled (status `PENDING_CONSENT`). There is no new account to open: the account holder must authorize this tenant to operate the existing account.
  - Allowed values: `PENDING`, `ACCEPTED`, `DECLINED`, `DENIED`, `EXPIRED`
- `consentLink` (string, optional) — Authorization page URL — deliver it to the account holder. The page requires an identity verification (live selfie checked against official records by CPF) and discloses account number and current balance before the authorization. Also delivered via `accreditation.consent.link.created`.
- `consentExpiresAt` (datetime, optional) — Consent link expiry (7 days). The journey expires after 30 days.
- `linkExpiresAt` (datetime, optional)

### ErrorResponsePartner

Raw error from the settlement bank, when the failure came from it. Diagnostic only.

- `code` (string, optional)
- `message` (string, optional)
- `field` (string, optional) — Field the partner pointed at, when any.

## Examples

**Response**

```json
{
  "accreditationId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
  "status": "retrying",
  "person": {
    "personId": "prs_3b1c9a7f2e4d",
    "cpf": "12345678900",
    "name": "MARIA DA SILVA",
    "biometryStatus": "PENDING",
    "biometryLink": "https://onboarding.corpx.com/c/8c1f6a2e",
    "acceptanceStatus": "COMPLETED",
    "acceptanceLink": "https://onboarding.corpx.com/c/8c1f6a2e",
    "consentStatus": "PENDING",
    "consentLink": "https://onboarding.corpx.com/c/8c1f6a2e",
    "consentExpiresAt": "2026-02-20T08:33:39Z",
    "linkExpiresAt": "2026-02-20T08:33:39Z"
  }
}
```

**SDK Code**

```python Accreditations_retryAccreditationPerson_example
import requests

url = "https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry"

headers = {
    "X-Tenant-Id": "X-Tenant-Id",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, headers=headers)

print(response.json())
```

```javascript Accreditations_retryAccreditationPerson_example
const url = 'https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry';
const options = {
  method: 'POST',
  headers: {'X-Tenant-Id': 'X-Tenant-Id', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Accreditations_retryAccreditationPerson_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-Tenant-Id", "X-Tenant-Id")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Accreditations_retryAccreditationPerson_example
require 'uri'
require 'net/http'

url = URI("https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Tenant-Id"] = 'X-Tenant-Id'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Accreditations_retryAccreditationPerson_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry")
  .header("X-Tenant-Id", "X-Tenant-Id")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Accreditations_retryAccreditationPerson_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Tenant-Id' => 'X-Tenant-Id',
  ],
]);

echo $response->getBody();
```

```csharp Accreditations_retryAccreditationPerson_example
using RestSharp;

var client = new RestClient("https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry");
var request = new RestRequest(Method.POST);
request.AddHeader("X-Tenant-Id", "X-Tenant-Id");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Accreditations_retryAccreditationPerson_example
import Foundation

let headers = [
  "X-Tenant-Id": "X-Tenant-Id",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://tenant.api.corpx.com/v1/accreditations/accreditationId/persons/cpf/retry")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```