Iyzipay Node.js SDK 使用指南

1. 项目介绍

iyzipay-node 是一个由 Iyzico 提供的 Node.js SDK，它允许开发者在 Node.js 应用中轻松集成 Iyzico 的支付功能。Iyzico 是一家知名的土耳其支付服务提供商，支持多种支付方式和交易类型，通过该 SDK，可以方便地进行支付、退款等操作。

2. 项目快速启动

首先，确保你已经安装了 Node.js 环境。然后，按照以下步骤进行操作：

1. 克隆或下载项目代码：

   git clone https://github.com/iyzico/iyzipay-node.git
   cd iyzipay-node
   

2. 安装项目依赖：

   npm install
   

3. 创建一个简单的支付请求示例文件 example.js，并添加以下内容：

   const Iyzipay = require('iyzipay');
   
   const iyzipay = new Iyzipay({
     apiKey: 'YOUR_API_KEY',
     secretKey: 'YOUR_SECRET_KEY',
     uri: 'https://sandbox-api.iyzipay.com'
   });
   
   const createPayment = () => {
     iyzipay.createPayment({
       locale: Iyzipay.Locale.TR,
       conversationId: '123456789',
       price: '100',
       paidPrice: '100',
       currency: Iyzipay.Currency.TRY,
       basketId: 'B67890',
       paymentChannel: Iyzipay.PaymentChannel.INVOICE,
       paymentGroup: Iyzipay.PaymentGroup.PRODUCT,
       buyer: {
         id: 'BY789',
         name: 'John',
         surname: 'Doe',
         email: '[e-mail]',
         gsmNumber: '[phone]',
         registrationAddress: {
           address: 'Nerede',
           city: 'Istanbul',
           country: 'Turkey'
         },
         ip: '85.34.78.112'
       },
       billingAddress: {
         address: 'Nerede',
         city: 'Istanbul',
         country: 'Turkey'
       },
       shippingAddress: {
         address: 'Nerede',
         city: 'Istanbul',
         country: 'Turkey'
       }
     }).then(result => {
       console.log(result);
     }).catch(err => {
       console.error(err);
     });
   };
   
   createPayment();
   

4. 运行示例文件以测试支付请求：

   node example.js
   

确保替换 YOUR_API_KEY 和 YOUR_SECRET_KEY 为你在 Iyzico 控制台生成的 API 密钥。

3. 应用案例和最佳实践

• 安全性：在处理支付信息时，确保所有数据传输都使用 HTTPS。
• 错误处理：正确处理支付请求可能出现的错误，例如网络问题或支付服务不可用。
• 日志记录：记录支付请求和响应的详细信息，以便在出现问题时进行调试。
• 测试：在集成到生产环境前，充分测试支付流程，确保所有功能按预期工作。

4. 典型生态项目

iyzipay-node 可以与各种 Node.js 框架和应用集成，例如 Express.js、Koa.js 等，以及与数据库和第三方服务进行交互，构建一个完整的电子商务解决方案。