HandyPay Ecommerce Paiements API

Public REST API pour intégrer les paiements HandyPay dans n'importe quelle application. Authentifier avec les clés API, gérer les produits, les clients, les sessions de paiement, les abonnements et recevoir des notifications webhook.

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.

HandyPay Ecommerce Paiements API

Base URL

https://api.handypay.me/api/v1

javascript

Version API: 2025-01-01 — retournés dans le X-API-Version entête sur chaque réponse.

Démarrer rapidement

Lève-toi et cours dans moins d'une minute. Prenez une clé API, configurer le client, faire une demande.

Obtenez votre clé API

Générer les clés de la Portail marchand- Oui. Toutes les demandes nécessitent un jeton porteur dans le Authorization Entête.

Authorization: Bearer hp_live_your_api_key_here

javascript

hp_test_Boîte à sable

hp_live_Production

Configurer le client API

Créez une fonction utilitaire réutilisable. Elle fonctionne avec Next.js, React Native et Node.js.

lib/handypay.ts

const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };

javascript

Entreposez votre clé dans .env comme HANDYPAY_API_KEY- Oui. Ne jamais exposer le côté client.

Faites votre première demande

Listez vos produits pour vérifier que tout fonctionne.

TypeScript

const products = await handypay("/products?limit=10");
console.log(products);

javascript

Équivalent en cURL

CURL

curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"

javascript

Vous devriez récupérer une réponse JSON avec "success": true et vos données de produit.

Limites de taux

1000 demandes par heure par clé API. Dépassant les limites de rendement 429 avec une Retry-After Entête.

Ce que vous pouvez construire

Paiements uniques

Créez des produits et des sessions de caisse hébergées pour des achats uniques.

Abonnements

Facturation récurrente avec intervalles flexibles, essais et annulation.

Multi-devises

Acceptez USD, JMD, CAD et plus encore dans 10 pays.

Webhooks

Notifications en temps réel pour le paiement et le cycle de vie de l'abonnement.

Intervalles de facturation

Les produits d'abonnement supportent les intervalles de facturation récurrents suivants.

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

Prochaines étapes

Consultez la référence complète de l’API pour les détails des endpoints, ou accédez directement aux recettes d’intégration pour Next.js, React Native et Express.