PayGuardian IOS SDK

The constructor of the BPNPaymentRequest object is:

- (instancetype) initInvoiceNumber: (NSString *_Nonnull) invoiceNumber
pnRefNum: (NSString *_Nullable) pnRefNum
amount: (NSDecimalNumber *_Nullable) amount 
tipAmount: (NSDecimalNumber *_Nullable) tipAmount
cashBackAmount: (NSDecimalNumber *_Nullable) cashBackAmount
tenderType: (NSString *_Nonnull) tenderType
transactionType: (NSString *_Nonnull) transactionType
username: (NSString *_Nonnull) username
password: (NSString *_Nonnull) password
merchantCode: (NSString *_Nonnull) merchantCode
merchantAccountCode: (NSString *_Nonnull) merchantAccountCode
paymentAccountNumber: (NSString *_Nullable) paymentAccountNumber
token: (NSString *_Nullable) token
expirationDate: (NSString *_Nullable) expirationDate
terminalCommConfig: (TerminalCommConfig *_Nonnull) terminalCommConfig
industryType: (NSString *_Nonnull) industryType
healthCareData: (BPNHealthCare *_Nullable) healthCareData 
bankAccountNumber: (NSString *_Nullable) bankAccountNumber
routingNumber: (NSString *_Nullable) routingNumber
partialApproval: (BOOL) partialApproval
enableTpi: (BOOL) enableTpi
signatureData: (NSString *_Nullable) signatureData 
disableAmountConfirmation: (BOOL) disableAmountConfirmation
testMode: (BOOL) testMode;

 _request = [BPNPaymentRequest alloc];
 [_request setInvoiceNumber: (NSString *_Nonnull) invoiceNumber];
 [_request setAmount: (NSDecimalNumber *_Nullable) amount];
 [_request setTenderType: (NSString *_Nonnull) tenderType];
 [_request setTransactionType: (NSString *_Nonnull) transactionType];
 [_request setUsername: (NSString *_Nonnull) username];
 [_request setPassword: (NSString *_Nonnull) password];
 [_request setMerchantCode: (NSString *_Nonnull) merchantCode];
 [_request setMerchantAccountCode: (NSString *_Nonnull) merchantAccountCode];
 [_request setTerminalCommConfig: (TerminalCommConfig *_Nonnull) terminalCommConfig];
 [_request setIndustryType: (NSString *_Nonnull) industryType];

initWithPaymentRequest:(BPNPaymentRequest *)request;

- (void)runOnCompletion: (void (^)(BPNPayment *payment, NSError *error)) onCompletion
onStateChanged: (void (^)(PayGuardianTransactionState state)) onStateChanged;

  _request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @”8888”
pnRefNum: nil
amount: [NSDecimalNumber decimalNumberWithString:@"5.50"]
tipAmount: nil
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT 
transactionType: TRANSACTION_TYPE_SALE
username: @"emvpgtest"
password: @"57!sE@3Fm" 
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalType: (Valid terminal type here)
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL 
healthCareData: nil
disableEMV: NO
testMode: YES];

_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change
}];

BPNPayment.BridgeCommResponse:
transactionID: 8888
requestType: 004
responseCode: 0
responseDescription: Successful Request
token: 11110000000068530608
expirationDate: 1225
authorizationCode: 290144
originalReferenceNumber: MCC7754741020
authorizedAmount: $5.50
originalAmount: $5.50
gatewayTransactionID: 214973401
gatewayMessage: A01 - Approved
internalMessage: Approved: 290144 (approval code)
gatewayResult: 00000
AVSMessage:
AVSResponse:
CVMessage:
CVResult:
transactionCode: (null)
transactionDate: 20161020
remainingAmount: $0.00
ISOCountryCode: (null)
ISOCurrencyCode: USD
ISOTransactionDate: 2016-10-20 14:32:47.86
ISORequestDate: 2016-10-20 14:32:47.86
networkReferenceNumber: MCC7754741020
merchantCategoryCode:
networkMerchantID: 518564010126944
networkTerminalID: PPB01.
cardType: Mastercard
maskedPAN: 5***********0608
responseTypeDescription: sale
isCommercialCard: False
streetMatchMessage:
secondsRemaining: (null)
merchantCode: (null)
merchantAccountCode: (null)
merchantName: (null)
receiptTagData: (null)
issuerTagData: (null)
applicationIdentifier: (null)
terminalVerificationResults: (null)
issuerApplicationData: (null)
transactionStatusInformation: (null)

BPNPayment.BPNReceipt:
maskedCardNumber: 5***********0608:
chipCardAID: (null) //← No AID for non-emv trx
invoice: 8888
seq: 8888
authorizationCode: 290144
entryMethod: Swipe_Read
totalAmount: 5.5
appLabel:
cardHolderName: (null)
networkMerchantId: 518564010126944
networkTerminalId: PPB01.
cardFirstFour: 5413
cardType: Mastercard
requiresSignature: YES
pinEntered: NO

_request = [[BPNPaymentRequest alloc]

initInvoiceNumber: @”33333”
pnRefNum: nil
amount: [NSDecimalNumber decimalNumberWithString:@"7.50"]
tipAmount: nil
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_SALE_AUTH
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalType: (Valid terminal type here)
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
disableEMV: NO
testMode: YES];

_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change
}];

BPNPayment.BridgeCommResponse:
transactionID: 33333
requestType: 004
responseCode: 0
responseDescription: Successful Request
token: 11110000000077149269
expirationDate: 0325
authorizationCode: 786986
originalReferenceNumber:
authorizedAmount: $7.50
originalAmount: $7.50
gatewayTransactionID: 214972201
gatewayMessage: A01 - Approved
internalMessage: Approved: 786986 (approval code)
gatewayResult: 00000
AVSMessage:
AVSResponse:
CVMessage:
CVResult:
transactionCode: (null)
transactionDate: 20161020
remainingAmount: $0.00
ISOCountryCode: (null)
ISOCurrencyCode: USD
ISOTransactionDate: 2016-10-20 14:02:46.153
ISORequestDate: 2016-10-20 14:02:46.153
networkReferenceNumber:
merchantCategoryCode:
networkMerchantID: 518564010126944
networkTerminalID: PPB01.
cardType: Visa
maskedPAN: 4***********9269
responseTypeDescription: auth
isCommercialCard: False
streetMatchMessage:
secondsRemaining: (null)
merchantCode: (null)
merchantAccountCode: (null)
merchantName: (null)
receiptTagData: 4F:A0000000031010;95:8080008000;9F10:06010A03A00000;9B:6800;91:;8A:
issuerTagData:
applicationIdentifier: A0000000031010
terminalVerificationResults: 8080008000
issuerApplicationData: 06010A03A00000
transactionStatusInformation: 6800

BPNPayment.BPNReceipt:
maskedCardNumber: 4***********9269:
chipCardAID: A0000000031010
invoice: 33333
seq: 33333
authorizationCode: 786986
entryMethod: Chip_Read
totalAmount: 7.5
appLabel: VISA DEBIT
cardHolderName: CARDHOLDER/VALUED
networkMerchantId: 518564010126944
networkTerminalId: PPB01.
cardFirstFour: 4204
cardType: Visa
requiresSignature: YES
pinEntered: NO

 _request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @”33333”
pnRefNum: @”214972201” //gatewayTransactionID from SALE_AUTH
amount: [NSDecimalNumber decimalNumberWithString:@"9.50"] //adjust amount with tip
tipAmount: [NSDecimalNumber decimalNumberWithString:@"2.00"] //tip amount for record
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_CAPTURE
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalType: nil
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
disableEMV: NO
testMode: YES];
_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change
}];

BPNPayment.BridgeCommResponse:
transactionID: 33333
requestType: 019
responseCode: 0
responseDescription: Successful Request
token: (null)
expirationDate: (null)
authorizationCode: (null)
originalReferenceNumber:
authorizedAmount: $0.00
originalAmount: $0.00
gatewayTransactionID: 214972201
gatewayMessage: A01 - Approved
internalMessage: (null)
gatewayResult: 00000
AVSMessage: (null)
AVSResponse: (null)
CVMessage: (null)
CVResult: (null)
transactionCode: (null)
transactionDate: (null)
remainingAmount: $0.00
ISOCountryCode: (null)
ISOCurrencyCode: (null)
ISOTransactionDate: (null)
ISORequestDate: (null)
networkReferenceNumber: (null)
merchantCategoryCode: (null)
networkMerchantID: (null)
networkTerminalID: (null)
cardType: (null)
maskedPAN:
responseTypeDescription: (null)
isCommercialCard: (null)
streetMatchMessage: (null)
secondsRemaining: (null)
merchantCode: (null)
merchantAccountCode: (null)
merchantName: (null)
receiptTagData: (null)
issuerTagData: (null)
applicationIdentifier: (null)
terminalVerificationResults: (null)
issuerApplicationData: (null)
transactionStatusInformation: (null)

BPNPayment.BPNReceipt:
maskedCardNumber: :
chipCardAID: (null)
invoice: 33333
seq: 33333
authorizationCode: (null)
entryMethod: (null)
totalAmount: (null)
appLabel:
cardHolderName: (null)
networkMerchantId: (null)
networkTerminalId: (null)
cardFirstFour: (null)
cardType: (null)
requiresSignature: NO
pinEntered: NO

_request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @”8888”
pnRefNum: @”235531904” //gatewayTransactionID from SALE
amount: nil //adjustment will be calculated at gateway from tip
tipAmount: [NSDecimalNumber decimalNumberWithString:@"2.00"] //tip amount for adjustment
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_TIP_ADJUST
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalType: nil
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
disableEMV: NO
testMode: YES];
_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change
}];

BPNPayment.BridgeCommResponse:
transactionID: 8888
requestType: 004
responseCode: 00000
responseDescription: Successful Request
token: (null)
expirationDate: (null)
authorizationCode: 987090
ReferenceNumber:
authorizedAmount: $7.00
originalAmount: $5.00
gatewayTransactionID: 235531904
gatewayMessage: A12 – Tip Adjustment Posted
internalMessage: Tip Adjustment Posted
gatewayResult: 00000
AVSMessage: (null)
AVSResponse: (null)
CVMessage: (null)
CVResult: (null)
transactionCode: (null)
transactionDate: (null)
remainingAmount: $0.00
ISOCountryCode: (null)
ISOCurrencyCode: (null)
ISOTransactionDate: (null)
ISORequestDate: (null)
networkReferenceNumber: (null)
merchantCategoryCode: (null)
networkMerchantID: (null)
networkTerminalID: (null)
cardType: (null)
maskedPAN:
responseTypeDescription: (null)
isCommercialCard: False
streetMatchMessage: (null)
WalletID: (null)
WalletPaymentMethodID: (null)
WalletResponseCode: (null)
WalletResponseMessage: (null)

_request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @”33333”
pnRefNum: nil
amount: [NSDecimalNumber decimalNumberWithString:@"8.00"]
tipAmount: nil
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_SALE
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: @"11110000000077149269" // ← Token from a previous sale or auth
expirationDate: @”0325” //← expirationDate used with Token
terminalType: nil // ← terminalType not used with Token
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
disableEMV: NO
testMode: YES];

_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change
}];

BPNPayment.BridgeCommResponse:
transactionID: 33333
requestType: 004
responseCode: 0
responseDescription: Successful Request
token: 11110000000077149269
expirationDate: 0325
authorizationCode: 099912
originalReferenceNumber:
authorizedAmount: $8.F00
originalAmount: $8.00
gatewayTransactionID: 214972001
gatewayMessage: A01 - Approved
internalMessage: Approved: 099912 (approval code)
gatewayResult: 00000
AVSMessage:
AVSResponse:
CVMessage:
CVResult:
transactionCode: (null)
transactionDate: 20161020
remainingAmount: $0.00
ISOCountryCode: (null)
ISOCurrencyCode: USD
ISOTransactionDate: 2016-10-20 13:55:27.3
ISORequestDate: 2016-10-20 13:55:27.3
networkReferenceNumber:
merchantCategoryCode:
networkMerchantID: 518564010126944
networkTerminalID: PPB01.
cardType:
maskedPAN:
responseTypeDescription: sale
isCommercialCard: False
streetMatchMessage:
secondsRemaining: (null)
merchantCode: (null)
merchantAccountCode: (null)
merchantName: (null)
receiptTagData: (null)
issuerTagData: (null)
applicationIdentifier: (null)
terminalVerificationResults: (null)
issuerApplicationData: (null)
transactionStatusInformation: (null)

BPNPayment.BPNReceipt:
maskedCardNumber: :
chipCardAID: (null)
invoice: 33333
seq: 33333
authorizationCode: 099912
entryMethod: (null)
totalAmount: 8
appLabel:
cardHolderName: (null)
networkMerchantId: 518564010126944
networkTerminalId: PPB01.
cardFirstFour: (null)
cardType:
requiresSignature: NO
pinEntered: NO

_request = [[BPNPaymentRequest alloc]
initWithAmount: [NSDecimalNumber decimalNumberWithString:@"7.00"]
tipAmount: nil
invoiceNumber: @"12345"
tenderType: @"abcd" //<----- Invalid Tender Type will fail validation
transactionType: TRANSACTION_TYPE_SALE
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
originalReferenceNumber: nil
connectionService: nil
connectionQueue: queue
cashBackAmount: nil
PaymentAccountNumber: nil
ExpirationDate: @""
shippingAddress: nil
DeviceType: @"icmp"
testMode: YES
withToken: @""];
 
_transaction = [[PayGuardianTransaction alloc]
initWithPaymentRequest:_request];
 
  [_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
  //process response

  } onStateChanged: ^(PayGuardianTransactionState state) {
  //process state change

  }];

NSError:

Error Domain= com.bridgepaynetwork.PayGuardian
Code= 2 "Invalid payment request"
UserInfo= {NSLocalizedDescription=Invalid payment request}

_request = [[BPNPaymentRequest alloc]
initWithAmount: [NSDecimalNumber decimalNumberWithString:@"6.75"]
tipAmount: nil
invoiceNumber: @"7575"
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_SALE
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
originalReferenceNumber: nil
connectionService: nil
connectionQueue: queue
cashBackAmount: nil
PaymentAccountNumber: nil
ExpirationDate: nil
shippingAddress: nil
DeviceType: nil
testMode: YES
withToken: nil];
_transaction = [[PayGuardianTransaction alloc]
initWithPaymentRequest:_request];

[_transaction runOnCompletion: ^(BPNPayment *payment, NSError *error) {
//process response

} onStateChanged: ^(PayGuardianTransactionState state) {
//process state change

}];

Error Domain= com.bridgepaynetwork.PayGuardian
Code= 6 "Card failed to read"
UserInfo= {NSLocalizedDescription=Card failed to read}

terminalCommConfig.terminalType = nil; //no terminal used
_request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @"invoiceID111"
pnRefNum: nil
amount: [NSDecimalNumber decimalNumberWithString:@"12.33"]
tipAmount: nil
cashBackAmount: nil
tenderType: TENDER_TYPE_DEBIT
transactionType: TRANSACTION_TYPE_PCI_TOKEN // token payment
username: @"User"
password: @"Password "
merchantCode: @"0000”
merchantAccountCode: @"0000"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalCommConfig: terminalCommConfig
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
bankAccountNumber: nil
routingNumber: nil
partialApproval: YES
enableTpi: NO
tpiUrl: nil
signatureData: nil
disableAmountConfirmation: YES
testMode: YES];
[_request setPrivateKey:@"4H#########NXYu"];
[_request setAuthenticationTokenId:token]; // token from TokenPay.js form

_request = [[BPNPaymentRequest alloc]
init: _terminalCommConfig
username: @"username"
password: @"password"
merchantCode: @"000000"
merchantAccountCode: @"000001"
tenderType: TENDER_TYPE_CREDIT
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
invoiceNumber: [formatter stringFromDate:[NSDate date]]
amount: [NSDecimalNumber decimalNumberWithString:@"12.00"]
tipAmount: [NSDecimalNumber decimalNumberWithString:@"3.00"]
cashBackAmount: nil
testMode: true];

_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion:^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged:^(PayGuardianTransactionState state) {
//process state change
}];

_request = [[BPNTokenRequest alloc]
initTokenRequest: @"username"
password: @"password"
merchantCode: @"000000"
merchantAccountCode: @"000001"
publicKey: @"publicKey"
paymentAccountNumber: @"0000000000000000"
expirationDate: @"0000"
testMode: true];

_transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
[_transaction runOnCompletion:^(BPNPayment *payment, NSError *error) {
//process response
} onStateChanged:^(PayGuardianTransactionState state) {
//process state change
}];

_request = [[BPNTokenRequest alloc]
initSaleRequest: @"username"
password: @"password"
merchantCode: @"000000"
merchantAccountCode: @"000001"
industryType: TRANSACTION_INDUSTRY_TYPE_RETAIL
privateKey: @"privateKey"
authenticationTokenId: @"authTokenId"
amount: [NSDecimalNumber decimalNumberWithString:@"12.00"]
testMode: true];
 
    _transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
    [_transaction runOnCompletion:^(BPNPayment *payment, NSError *error) {
    //process response
    } onStateChanged:^(PayGuardianTransactionState state) {
   //process state change

_request = [[BPNFindRequest alloc]
init: @"username"
password: @"password"
merchantCode: @"000000"
merchantAccountCode: @"000001"
invoiceNumber: @"invoiceNumber"
gatewayTransID: @"gatewayTransId"
purchaseToken: @"purchaseToken"
testMode: true];
   
    _transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
    [_transaction runOnCompletion:^(BPNPayment *payment, NSError *error) {
    //process response
    } onStateChanged:^(PayGuardianTransactionState state) {
   //process state change

_request = [[BPNPaymentRequest alloc]
initInvoiceNumber: @"8888"
pnRefNum: nil
amount: [NSDecimalNumber decimalNumberWithString:@"0.00"]
tipAmount: nil
cashBackAmount: nil
tenderType: TENDER_TYPE_CREDIT
transactionType: TRANSACTION_TYPE_ACCOUNT_VERIFICATION
username: @"emvpgtest"
password: @"57!sE@3Fm"
merchantCode: @"320000"
merchantAccountCode: @"320001"
paymentAccountNumber: nil
token: nil
expirationDate: nil
terminalType: (Valid terminal type here)
transactionType: TRANSACTION_INDUSTRY_TYPE_RETAIL
healthCareData: nil
disableEMV: NO
testMode: YES];
 
   
    _transaction = [[PayGuardianTransaction alloc] initWithPaymentRequest:_request];
    [_transaction runOnCompletion:^(BPNPayment *payment, NSError *error) {
    //process response
    } onStateChanged:^(PayGuardianTransactionState state) {
   //process state change
   }];