Intégrez Freda Pay avec votre assistant IA

Authorization: Bearer sk_test_VOTRE_CLE_SECRETE
Content-Type: application/json

curl -X POST https://api.fredapay.com/v1/payments \
  -H "Authorization: Bearer sk_test_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1500,
    "method": "moncash",
    "reference": "CMD-1001"
  }'

const res = await fetch("https://api.fredapay.com/v1/payments", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FREDA_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ amount: 1500, method: "moncash", reference: "CMD-1001" }),
});
const payment = await res.json();
// Redirigez le client :
// res.redirect(payment.checkout_url)

<?php
$ch = curl_init("https://api.fredapay.com/v1/payments");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("FREDA_SECRET_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "amount" => 1500,
    "method" => "moncash",
    "reference" => "CMD-1001",
  ]),
]);
$payment = json_decode(curl_exec($ch), true);
header("Location: " . $payment["checkout_url"]);

import os, requests

r = requests.post(
    "https://api.fredapay.com/v1/payments",
    headers={"Authorization": f"Bearer {os.environ['FREDA_SECRET_KEY']}"},
    json={"amount": 1500, "method": "moncash", "reference": "CMD-1001"},
)
payment = r.json()
# Redirigez le client vers payment["checkout_url"]

{
  "id": "pay_8f2a91c4d0e1b7a3",
  "reference": "CMD-1001",
  "amount": 1500,
  "currency": "HTG",
  "method": "moncash",
  "status": "pending",
  "fee": null,
  "net_amount": null,
  "checkout_url": "https://…",
  "created_at": "2026-09-24T14:02:11Z"
}

curl https://api.fredapay.com/v1/payments/pay_8f2a91c4d0e1b7a3 \
  -H "Authorization: Bearer sk_test_VOTRE_CLE"

async function waitForPayment(id) {
  for (let i = 0; i < 120; i++) {
    const res = await fetch(`https://api.fredapay.com/v1/payments/${id}`, {
      headers: { Authorization: `Bearer ${process.env.FREDA_SECRET_KEY}` },
    });
    const p = await res.json();
    if (p.status !== "pending") return p;
    await new Promise(r => setTimeout(r, 5000));
  }
  return null; // abandonné
}

<?php
$ch = curl_init("https://api.fredapay.com/v1/payments/" . $paymentId);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("FREDA_SECRET_KEY")],
]);
$payment = json_decode(curl_exec($ch), true);
if ($payment["status"] === "succeeded") {
  // marquez la commande comme payée
}

import os, time, requests

def wait_for_payment(payment_id):
    headers = {"Authorization": f"Bearer {os.environ['FREDA_SECRET_KEY']}"}
    for _ in range(120):
        p = requests.get(f"https://api.fredapay.com/v1/payments/{payment_id}", headers=headers).json()
        if p["status"] != "pending":
            return p
        time.sleep(5)
    return None

POST /webhooks/freda HTTP/1.1
X-Freda-Signature: sha256=5f4d...b2a1
X-Freda-Event-Id: evt_8f2a91c4d0e1
X-Freda-Delivery-Attempt: 1
Content-Type: application/json

{
  "id": "evt_8f2a91c4d0e1",
  "event": "payment.succeeded",
  "created_at": "2026-09-27T10:15:00Z",
  "data": {
    "id": "pay_7c1a...",
    "reference": "CMD-001",
    "amount": 1000,
    "currency": "HTG",
    "net_amount": 930
  }
}

const crypto = require("crypto");

function isValid(rawBody, signatureHeader, secret) {
  const expected = crypto.createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  const received = signatureHeader.replace("sha256=", "");
  return crypto.timingSafeEqual(
    Buffer.from(expected), Buffer.from(received)
  );
}
// Utilisez rawBody AVANT tout JSON.parse : un corps
// re-sérialisé ne redonne pas les mêmes octets.

curl -X POST https://api.fredapay.com/v1/payouts \
  -H "Authorization: Bearer sk_test_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "method": "natcash",
    "recipient": "50937001234",
    "reference": "RET-2026-001"
  }'

const res = await fetch("https://api.fredapay.com/v1/payouts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FREDA_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount: 500,
    method: "natcash",
    recipient: "50937001234",
    reference: "RET-2026-001",
  }),
});
const payout = await res.json(); // status: "pending"

<?php
$ch = curl_init("https://api.fredapay.com/v1/payouts");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("FREDA_SECRET_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "amount" => 500,
    "method" => "natcash",
    "recipient" => "50937001234",
    "reference" => "RET-2026-001",
  ]),
]);
$payout = json_decode(curl_exec($ch), true);

import os, requests

r = requests.post(
    "https://api.fredapay.com/v1/payouts",
    headers={"Authorization": f"Bearer {os.environ['FREDA_SECRET_KEY']}"},
    json={
        "amount": 500,
        "method": "natcash",
        "recipient": "50937001234",
        "reference": "RET-2026-001",
    },
)
payout = r.json()  # status: "pending"

curl https://api.fredapay.com/v1/payouts/po_3c9e71aa04b2d58f \
  -H "Authorization: Bearer sk_test_VOTRE_CLE"

{
  "id": "po_3c9e71aa04b2d58f",
  "reference": "RET-2026-001",
  "amount": 500,
  "method": "natcash",
  "recipient": "50937001234",
  "status": "success",
  "fee": 12.5,
  "failure_reason": null
}

curl https://api.fredapay.com/v1/balance \
  -H "Authorization: Bearer sk_test_VOTRE_CLE"

{
  "gateway": { "available": 12400, "currency": "HTG" },
  "gateway_usd": { "available": 182.3, "currency": "USD" },
  "master_wallet": { "available": 95.96, "currency": "USD" }
}

curl -X POST https://api.fredapay.com/v1/cards/holders \
  -H "Authorization: Bearer sk_test_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Rose",
    "lastName": "Lakay",
    "email": "rose@example.com",
    "country": "US",
    "dob": "1990-05-12",
    "identificationNumber": "ID123456",
    "identity": { "type": "PASSPORT", "number": "P1234567", "imageUrl": "data:image/jpeg;base64,/9j/4AAQ...", "country": "US" },
    "phoneShortCode": "+1",
    "phoneNumber": "37001234",
    "address": { "street": "350 Fifth Avenue", "city": "New York", "state": "NY", "postalCode": "HT6110", "country": "US" }
  }'

{
  "id": "mpc_1a2b3c4d5e6f7a8b",
  "already_existed": false,
  "holder": {
    "id": "mpc_1a2b3c4d5e6f7a8b",
    "mode": "sandbox",
    "status": "enrolled",
    "first_name": "Rose",
    "last_name": "Lakay",
    "email": "rose@example.com",
    "country": "US",
    "photo_url": null,
    "dob": "1990-05-12",
    "phone": "+137001234",
    "address": { "street": "350 Fifth Avenue", "city": "New York", "state": "NY", "postalCode": "HT6110", "country": "US" },
    "identification_number_last4": "3456",
    "failure_reason": null,
    "created_at": "2026-10-11T10:00:00.000Z"
  },
  "profile": { /* même objet que holder (ancien nom, conservé) */ }
}

{ "holders": [
    { "id": "mpc_1a2b3c4d5e6f7a8b", "mode": "sandbox", "status": "enrolled",
      "first_name": "Rose", "last_name": "Lakay", "email": "rose@example.com",
      "country": "US", "photo_url": null, "failure_reason": null,
      "created_at": "2026-10-11T10:00:00.000Z" }
] }
// GET /v1/cards/holders/mpc_1a2b… renvoie { "holder": { …même objet… } }

400 MISSING_FIELDS     champ ou adresse incomplète (le message liste les champs)
400 INVALID_PHOTO      photoUrl invalide ou trop lourde
400 INVALID_JSON       corps non JSON
401 MISSING_API_KEY / INVALID_API_KEY
403 LIVE_NOT_ENABLED   clé live avant vérification du compte
502 HOLDER_CREATION_FAILED  le service de cartes n'a pas créé le titulaire
502 CARD_SERVICE_ERROR / 503 CARD_PROVIDER_AUTH  service de cartes en erreur
(un titulaire en échec est conservé avec status "failed" + failure_reason)

curl -X POST https://api.fredapay.com/dashboard/cards \
  -H "Authorization: Bearer VOTRE_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "CARD-001",
    "brand": "VISA",
    "amount": 20
  }'

const res = await fetch("https://api.fredapay.com/dashboard/cards", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${sessionToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ reference: "CARD-001", brand: "VISA", amount: 20 }),
});
const card = await res.json(); // status: "pending"

{
  "id": "card_8f2a91c4d0e1",
  "reference": "CARD-001",
  "kind": "individual",
  "brand": "VISA",
  "status": "pending",
  "created_at": "2026-09-25T04:15:04Z"
}

<div data-freda-link="lnk_VOTRE_LIEN"></div>
<script src="https://pay.fredapay.com/freda-button.js" async></script>