PHPackages                             revenuewire/iso8583 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. revenuewire/iso8583

ActiveLibrary

revenuewire/iso8583
===================

FirstData ISO 8583 Global Specification

044PHP

Since Mar 15Pushed 7y ago2 watchersCompare

[ Source](https://github.com/revenuewire/ISO8583)[ Packagist](https://packagist.org/packages/revenuewire/iso8583)[ RSS](/packages/revenuewire-iso8583/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

[![Build Status](https://camo.githubusercontent.com/df3dfaac582770443f85a060dd9b83bf12c159695152aec4b9e0f30abe7b1c8f/68747470733a2f2f7472617669732d63692e6f72672f726576656e7565776972652f49534f383538332e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/revenuewire/ISO8583)[![Coverage Status](https://camo.githubusercontent.com/47f4b1c5492b036f6b0bef05f2bb7e9499bf1f29b5069e84a17b4818f932a339/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f726576656e7565776972652f49534f383538332f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/revenuewire/ISO8583?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/c6439bb5617dc6ecb6e5c2e462463ab2ebd983ee7310c317a70373aa4609614d/68747470733a2f2f706f7365722e707567782e6f72672f726576656e7565776972652f69736f383538332f762f737461626c65)](https://packagist.org/packages/revenuewire/iso8583)[![License](https://camo.githubusercontent.com/ef4f814d682ab5b09468080317a2ae1ebf75923c09085dc4261b3d29f8beb761/68747470733a2f2f706f7365722e707567782e6f72672f726576656e7565776972652f69736f383538332f6c6963656e7365)](https://packagist.org/packages/revenuewire/iso8583)[![composer.lock](https://camo.githubusercontent.com/02c5cdbe40b174e6452d9ca0f21f99fb38218793180b77d83908e81000500ef6/68747470733a2f2f706f7365722e707567782e6f72672f726576656e7565776972652f69736f383538332f636f6d706f7365726c6f636b)](https://packagist.org/packages/revenuewire/iso8583)

Quick Start
===========

[](#quick-start)

Install
-------

[](#install)

```
composer require revenuewire/ISO8583
```

Specs
=====

[](#specs)

**Warning**: This library is not a generic ISO8583 implementation. The library is specially coded to implement the following specs

1. FirstData ISO 8583 Global Specification - Version 2017-2a
2. FirstData ISO 8583 Global TransArmor Addendum Document - Version 2016-1a

Also, not all tables are implemented. Many tables such as Canadian Debit support has no business values at our company at the moment. Token support such as ApplePay and AndroidPay are items that under road map.

Supported Bitmaps
-----------------

[](#supported-bitmaps)

BitmapNoteMTIMessage Type IDBitmap 2Primary Account NumberBitmap 3Processing CodeBitmap 4Amount of TransactionBitmap 7Transmission Date/TimeBitmap 11System Trace/Debit Reg E Receipt NumberBitmap 12Time, Local TransmissionBitmap 13Date, Local Trans. (Debit/EBT)/Sales Date (Credit)Bitmap 14Card Expiration DateBitmap 18Merchant Category CodeBitmap 22POS Entry Mode+ PIN CapabilityBitmap 23Card Sequence NumberBitmap 24Network International ID (NII)Bitmap 25Point of Service (POS) Condition CodeBitmap 31Acquirer Reference DataBitmap 35Acquiring IDBitmap 37Retrieval Reference NumberBitmap 39ResponseBitmap 41Terminal IDBitmap 42Merchant IDBitmap 43Alternative Merchant Name/LocationBitmap 44AVSBitmap 49Transaction Currency CodeBitmap 59Merchant Zip/Postal CodeBitmap 63First Data Private Use Data ElementBitmap 70Network Management Information CodeSupported Tables
----------------

[](#supported-tables)

BitmapTableNoteBitmap 63Table 14Additional VISA/MC/DS/AMEX InfoBitmap 63Table SKAMEX Safe KeyBitmap 63Table 49Card Code Value (CCV)Bitmap 63Table 36Additional Addendum DataBitmap 63Table 55Merchant Advice CodeBitmap 63Table 60eCommerce InfoBitmap 63Table VIVisa Compliance Field Identifier TableBitmap 63Table MCMastercard Compliance Field Identifier TableBitmap 63Table DSDiscovery Compliance Field Identifier TableBitmap 63Table SPTransArmor TokenUnit tests
==========

[](#unit-tests)

```
docker-compose build unittest
sh ./bin/go-test.sh
```

Examples
========

[](#examples)

pre-auth only transaction
-------------------------

[](#pre-auth-only-transaction)

```
 /**
 * ISO8583 Payload
 */
$iso8583 = new ISO8583();

/**
* MTI
*/
$iso8583->setMTI(ISO8583::FD_MTI_CREDIT_AUTH_REQUEST);

/**
 * Bit 2
 */
$iso8583->setData(ISO8583::FD_BIT_2_PRIMARY_ACCOUNT_NUMBER, ISO8583::getBit2PrimaryAccountNumber($cardNumber));

/**
* Bit 3
*/
$iso8583->setData(ISO8583::FD_BIT_3_PROCESSING_CODE, ISO8583::FD_PC_000000_CREDIT_CARD_PURCHASE);

/**
 * Bit 4
 */
$iso8583->setData(ISO8583::FD_BIT_4_AMOUNT_OF_TRANSACTION, $amount);

/**
 * Bit 7
 */
$iso8583->setData(ISO8583::FD_BIT_7_TRANSMISSION_DATETIME, date("mdHis"));

/**
 * Bit 11
 */
$iso8583->setData(ISO8583::FD_BIT_11_SYSTEM_TRACE_DEBIT_REG_RECEIPT_NUMBER, (string) $systemTraceNumber);

/**
 * Bit 14
 */
 $iso8583->setData(ISO8583::FD_BIT_14_CARD_EXPIRATION_DATE, $expiredDate);

 /**
  * Bit 22
  */
 $iso8583->setData(ISO8583::FD_BIT_22_POS_ENTRY_MODE, "010");

 /**
  * Bit 24
  */
 $iso8583->setData(ISO8583::FD_BIT_24_NETWORK_INTERNATIONAL_ID, "0001");

 /**
  * Bit 31
  */
 $iso8583->setData(ISO8583::FD_BIT_31_ACQUIRER_REFERENCE_DATA, ISO8583::FD_ARD_0_AUTHORIZATION_ONLY);

 /**
  * Bit 41,42
  */
 $iso8583->setData(ISO8583::FD_BIT_41_TERMINAL_ID, $tid);
 $iso8583->setData(ISO8583::FD_BIT_42_MERCHANT_ID, $mid);

 /**
  * Bit 49
  */
 $iso8583->setData(ISO8583::FD_BIT_49_TRANSACTION_CURRENCY_CODE, $paymentCurrency);

 /**
  * Bit 59
  */
 $iso8583->setData(ISO8583::FD_BIT_59_MERCHANT_ZIP, $merchantZip);

 /**
  * Bit 60
  */
 $iso8583->setData(ISO8583::FD_BIT_60_ADDITIONAL_POS_INFO, "01");

 /**
  * Bit 63 Table 14, VISA Transaction
  */
 $iso8583->addDataTable(ISO8583::FD_BIT_63_FD_PRIVATE_USE, ISO8583::FD_BIT_63_TABLE_14_ADDITIONAL_CARD_DATA, ISO8583::getBit63Table14AdditionalVisaData(["aci" => "Y"]));
 $iso8583->addDataTable(ISO8583::FD_BIT_63_FD_PRIVATE_USE, ISO8583::FD_BIT_63_TABLE_VI_COMPLIANCE, ISO8583::getBit63TableVIMCDSCompliance());

/**
  * Bit 63 Table SP, using TransArmor
  */
 $iso8583->addDataTable(ISO8583::FD_BIT_63_FD_PRIVATE_USE, ISO8583::FD_BIT_63_TABLE_SP_TRANS_ARMOR, ISO8583::getBit63TableSPTransArmorToken());

 return $iso8583->getEncodedISO();
```

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/734c4a5502142de0958b3e298555f3991ee0fd3203995dfa8c0c218835e428f8?d=identicon)[swang](/maintainers/swang)

---

Top Contributors

[![cosmostail](https://avatars.githubusercontent.com/u/2172362?v=4)](https://github.com/cosmostail "cosmostail (1 commits)")

### Embed Badge

![Health badge](/badges/revenuewire-iso8583/health.svg)

```
[![Health](https://phpackages.com/badges/revenuewire-iso8583/health.svg)](https://phpackages.com/packages/revenuewire-iso8583)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
