Pointer un virement à la main

POST/v1/payouts/{payout}/reconcile

Avec bank_transaction, rattache ce crédit du relevé au virement. Sans lui, pointe le virement tel quel, vu sur le compte. Le virement passe à reconciled, ses écarts gardés.

Droit de clé restreinte : batches:write.

Paramètres de chemin

payouttexteobligatoire
L'identifiant, po_….

Corps de la requête

bank_transactiontexteou null
Le crédit du relevé qui répond au virement, btx_…. Sans lui, le virement est pointé tel quel.

En-têtes

Idempotency-Keytexte
Rend le rejeu de cette écriture sûr pendant 24 heures. Idempotence.

Réponse

Rend l’objet virements.

Une erreur suit le format commun.

Requête

curl


curl -X POST https://api.ophelix.fr/v1/payouts/po_…/reconcile \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"bank_transaction":"btx_…"}'

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.ophelix.fr']);
 
$response = $client->post('/v1/payouts/po_…/reconcile', [
    'headers' => ['Authorization' => 'Bearer sk_test_…'],
    'json' => [
        'bank_transaction' => 'btx_…',
    ],
]);
$object = json_decode((string) $response->getBody(), true);

TypeScript


const response = await fetch('https://api.ophelix.fr/v1/payouts/po_…/reconcile', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_test_…', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    bank_transaction: 'btx_…'
  }),
})
const object = await response.json()

Réponse 200


{
  "id": "obj_…",
  "object": "payout",
  "status": "pending",
  "amount_cents": 0,
  "currency": "eur",
  "statement_descriptor": null,
  "label": {
    "line_1": null,
    "line_2": null
  },
  "accounting_date": null,
  "payer": null,
  "practitioner_number": null,
  "remittance": null,
  "payment_count": 0,
  "claim_count": 0,
  "detail_cents": 0,
  "breakdown": {
    "liquidation_cents": 0,
    "regularization_cents": 0,
    "one_off_payment_cents": 0,
    "deduction_cents": 0
  },
  "bank_transaction": null,
  "received_cents": 0,
  "arrival_date": null,
  "reconciliation": "automatic",
  "reconciled_at": null,
  "discrepancies": [
    {}
  ],
  "livemode": false,
  "created": 1793970000
}