iyzicopayment v2.1.1

iyzicopayment-node

You can sign up for an iyzico account at https://iyzico.com

Requirements

Node.js v0.10.0 or later

Installation

npm install iyzicopayment

Usage

Initialization

var iyzicopayment = require('iyzicopayment');

var iyzicopayment = new iyzicopayment({
    apiKey: 'your api key',
    secretKey: 'your secret key',
    uri: 'https://sandbox-api.iyzicopayment.com'
});

As you can see, credentials information provided while creating new instance of iyzicopayment class. If you do not provide iyzicopayment credentials, default values will be fetched from environment variables by following names.

   iyzicopayment_URI
   iyzicopayment_API_KEY
   iyzicopayment_SECRET_KEY

In other words, you can initialize iyzicopayment object like following:

var iyzicopayment = new iyzicopayment();

Sample Usage

var iyzicopayment = require('iyzicopayment');

var iyzicopayment = new iyzicopayment({
    apiKey: 'your api key',
    secretKey: 'your secret key',
    uri: 'https://sandbox-api.iyzicopayment.com'
});

var request = {
    locale: iyzicopayment.LOCALE.TR,
    conversationId: '123456789',
    price: '1',
    paidPrice: '1.2',
    currency: iyzicopayment.CURRENCY.TRY,
    installment: '1',
    basketId: 'B67832',
    paymentChannel: iyzicopayment.PAYMENT_CHANNEL.WEB,
    paymentGroup: iyzicopayment.PAYMENT_GROUP.PRODUCT,
    paymentCard: {
        cardHolderName: 'John Doe',
        cardNumber: '5528790000000008',
        expireMonth: '12',
        expireYear: '2030',
        cvc: '123',
        registerCard: '0'
    },
    buyer: {
        id: 'BY789',
        name: 'John',
        surname: 'Doe',
        gsmNumber: '+905350000000',
        email: 'email@email.com',
        identityNumber: '74300864791',
        lastLoginDate: '2015-10-05 12:43:35',
        registrationDate: '2013-04-21 15:12:09',
        registrationAddress: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
        ip: '85.34.78.112',
        city: 'Istanbul',
        country: 'Turkey',
        zipCode: '34732'
    },
    shippingAddress: {
        contactName: 'Jane Doe',
        city: 'Istanbul',
        country: 'Turkey',
        address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
        zipCode: '34742'
    },
    billingAddress: {
        contactName: 'Jane Doe',
        city: 'Istanbul',
        country: 'Turkey',
        address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
        zipCode: '34742'
    },
    basketItems: [
        {
            id: 'BI101',
            name: 'Binocular',
            category1: 'Collectibles',
            category2: 'Accessories',
            itemType: iyzicopayment.BASKET_ITEM_TYPE.PHYSICAL,
            price: '0.3'
        },
        {
            id: 'BI102',
            name: 'Game code',
            category1: 'Game',
            category2: 'Online Game Items',
            itemType: iyzicopayment.BASKET_ITEM_TYPE.VIRTUAL,
            price: '0.5'
        },
        {
            id: 'BI103',
            name: 'Usb',
            category1: 'Electronics',
            category2: 'Usb / Cable',
            itemType: iyzicopayment.BASKET_ITEM_TYPE.PHYSICAL,
            price: '0.2'
        }
    ]
};

iyzicopayment.payment.create(request, function (err, result) {
    console.log(err, result);
    done();
});

You can see further examples in test/samples folder, and run them by npm run-script samples

Mock test cards

Test cards that can be used to simulate a successful payment:

Cross border test cards:

Test cards to get specific error codes:

Mock APM Accounts

Mock APM Accounts that can be used to simulate a payment with alternative payment method:

Testing

You need to have mocha installed on your machine in order to run tests.

npm test

Author

Originally by Huseyin Babal (huseyinbabal88@gmail.com). Now officially maintained by iyzico.