# Payment context for a French company

Returns structured public counterparty context before an automated B2B payment. It never approves or recommends a payment.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/company/fr/payment-context`
- Price: `0.020 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- Returns structured public counterparty context before an automated B2B payment. It never approves or recommends a payment.
- You need compact public counterparty context immediately before an automated B2B payment.
- You want company status, legal-risk and compliance signals together without a full KYB dossier.

## Avoid when

- You only need existence or administrative status; use company/fr/verify.
- You need a broader multi-section company dossier; use company/fr/intelligence.

## Limitations

- This endpoint supplies decision context but never approves, blocks or recommends a payment.
- It does not verify bank-account ownership, invoice authenticity or private payment behavior.

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [https://recherche-entreprises.api.gouv.fr](https://recherche-entreprises.api.gouv.fr)
- [https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records](https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records)
- [https://www.data.gouv.fr/](https://www.data.gouv.fr/)
- [https://gels-avoirs.dgtresor.gouv.fr/](https://gels-avoirs.dgtresor.gouv.fr/)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "French company identifier: 9-digit SIREN or 14-digit SIRET."
        },
        "domain": {
            "type": "string",
            "description": "Optional domain supplied as additional counterparty context; it is checked separately and is not treated as proof of company ownership."
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the company/fr/payment-context API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "description": "Identifier supplied for the request, echoed in normalized form when applicable."
        },
        "identifier_type": {
            "type": "string",
            "description": "Normalized identifier type, such as SIREN or SIRET when applicable."
        },
        "exists": {
            "type": "boolean",
            "description": "Whether the requested company or public record was found in the checked source."
        },
        "siren": {
            "description": "Normalized 9-digit French SIREN when available."
        },
        "name": {
            "description": "Publicly available company, person, buyer or record name for this result."
        },
        "company_status": {
            "description": "Current public administrative company status when available."
        },
        "legal_risk": {
            "description": "Structured value returned for “legal risk” as defined by this API contract."
        },
        "compliance_status": {
            "type": "string",
            "description": "Structured value returned for “compliance status” as defined by this API contract."
        },
        "public_alerts_found": {
            "type": [
                "boolean",
                "null"
            ],
            "description": "Structured value returned for “public alerts found” as defined by this API contract."
        },
        "collective_procedure_events": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “collective procedure events” as defined by this API contract."
        },
        "radiation_events": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Structured value returned for “radiation events” as defined by this API contract."
        },
        "latest_relevant_event": {
            "description": "Structured value returned for “latest relevant event” as defined by this API contract."
        },
        "checked_at": {
            "type": "string",
            "description": "UTC timestamp at which HelpMyAgent performed the check."
        },
        "coverage": {
            "type": "array",
            "description": "Coverage information describing which underlying services or sources were available."
        },
        "limitations": {
            "type": "array",
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "company_status",
        "legal_risk",
        "compliance_status",
        "public_alerts_found",
        "collective_procedure_events",
        "radiation_events",
        "latest_relevant_event",
        "checked_at",
        "coverage"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the company/fr/payment-context API."
}
```

## Demonstration snapshot

This example is a database-stored snapshot and does not execute the live API.
- URL: https://api.helpmyagent.com/demo/company/fr/payment-context
- Generated at: 2026-09-07T14:49:19+00:00

## Request example

```json
{
    "identifier": "356000000"
}
```

## Stored response example

```json
{
    "identifier": "356000000",
    "identifier_type": "siren",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "company_status": "active",
    "legal_risk": "low",
    "compliance_status": "NO_PUBLIC_ALERT_FOUND",
    "public_alerts_found": false,
    "collective_procedure_events": 0,
    "radiation_events": 0,
    "latest_relevant_event": {
        "id": "B202601601781",
        "type": "modification",
        "publication_date": "2026-08-23",
        "event_date": null,
        "family_code": "modification",
        "family": "Modifications diverses",
        "notice_type": "Avis initial",
        "title": "Modifications diverses",
        "description": "modification survenue sur le capital (augmentation)",
        "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
        "department": "75",
        "city": "Paris",
        "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:B202601601781"
    },
    "checked_at": "2026-09-07T16:49:19+02:00",
    "coverage": [
        {
            "service": "verify",
            "status": "ok"
        },
        {
            "service": "profile",
            "status": "ok"
        },
        {
            "service": "risk",
            "status": "ok"
        },
        {
            "service": "events",
            "status": "ok"
        },
        {
            "service": "compliance",
            "status": "ok"
        }
    ],
    "limitations": [
        "L’absence d’alerte ne constitue ni une garantie de solvabilité ni une garantie d’absence de fraude.",
        "Ce service ne constitue pas un credit score, une décision KYB réglementaire complète ou une recommandation d’effectuer un paiement.",
        "Les résultats reflètent uniquement les informations publiques disponibles dans les sources effectivement interrogées."
    ]
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_error": true,
    "no_charge_on_empty_result": true
}
```