Skip to main content

BluePay

Overview​

Account Management: https://secure.bluepay.com
Developer Documentation: https://developer.cardconnect.com/bluepay-gateway#api-documentation (bp10emu) Default Currency: USD

Request Objects: BillingAddress, CreditCard, Check,OrderInfo

Gateway Endpoints
This implementation of BluePay forwards requests to the below endpoints.
Production: https://secure.bluepay.com/interfaces/bp10emu
Sandbox: https://secure.bluepay.com/interfaces/bp10emu

Supported Request Parameters​

* denotes a required field type column indicates max length
Field NameTypebp10emu MappingNotes
gatewaystringN/ABluePay
merchantId*string(12)MERCHANTBluePay Account ID
privateKey*stringUsed in TPS HashBluePay Secret Key
duplicateOverridebooleanDUPLICATEOVERRIDESet to true to turn off duplicate scrubbing for a transaction. Set to false or leave blank to process with duplicate scrubbing
responseVersionstringRESPONSEVERSION1-8+, All higher versions include lower versions. Defaults to 1 if left blank
descriptionstringCOMMENTBrief summary of the transaction
amountnumericAMOUNTTransaction amount in cents. Example: $10.00 should be sent as 1000
orderIdstring(128)ORDER_IDAn identifier for the payment from the merchant's system
docTypestringDOC_TYPEACH documentation type of agreement with payer: PPD, CCD, WEB, TEL. Defaults to WEB
customerIpAddressstringCUSTOMER_IPThe IP address of the customer's computer. When the customer does not post their payment directly to the BluePay Gateway, setting this value is helpful to take full advantage of BluePay's fraud prevention systems.
orderInfo.​PurchaseOrderNumberstringLV2_ITEM_CUST_POPurchase Order Number
orderInfo.​InvoiceNumberstring(10)INVOICE_IDAn identifier for the Invoice in Merchant's system
orderInfo.​CustomerIdstring(30)LV2_ITEM_CUSTOMER_NUMBERUnique identifier for customer within Merchant's system
creditCard.​NumberstringCC_NUMCard number or TokenEx Token - Tokenex will replace the Token with the Detokenized number
creditCard.​ExpMonthnumericCC_EXPIRESExpMonth and ExpYear (last two digits of passed four digits) are concatenated within Payment Services' BluePay Integration and passed into CC_EXPIRES. Example: 01 2025 becomes 0125
creditCard.​ExpYearnumericCC_EXPIRESExpMonth and ExpYear (last two digits of passed four digits) are concatenated within Payment Services' BluePay Integration and passed into CC_EXPIRES. Example: 01 2025 becomes 0125
creditCard.​CvvstringCVCCVV2Card verification value
tax.​Amountnumeric(6)AMOUNT_TAXTax amount in cents. Example: $10.00 should be sent as 1000
check.​AccountNumberstringACH_ACCOUNTACH account number or TokenEx Token - Tokenex will replace the Token with the Detokenized number
check.​RoutingNumberstringACH_ROUTINGContains the nine-digit bank routing ("ABA") number for the customer's bank account.
check.​AccountTypestringACH_ACCOUNT_TYPEValid input Values
1 or Checking
2 or Savings
3 or GeneralLedger
bp10emu mapping
Checking - C
Savings - S
GeneralLedger - G
billingAddress.​PhonestringPHONEPhone number for contact at billing address
billingAddress.​EmailstringEMAILEmail address for contact at billing address
billingAddress.​FullNamestringNAMEName associated with customer’s billing address. If left empty, field will default to billingAddress.FirstName + billingAddress.Lastname.
billingAddress.​FirstNamestringNAMEName associated with customer’s billing address. FirstName and Lastname are space-separated and sent in NAME if FullName is empty.
billingAddress.​LastNamestringNAMEName associated with customer’s billing address. FirstName and Lastname are space-separated and sent in NAME if FullName is empty.
billingAddress.​CompanystringCOMPANY_NAMEName of company at billing address
billingAddress.​Address1stringADDR1First line of customer’s billing address
billingAddress.​Address2stringADDR2Second line of customer’s billing address
billingAddress.​CitystringCITYCity of customer’s billing address
billingAddress.​StatestringSTATEState of customer’s billing address
billingAddress.​ZipstringZIPCODEZip code of customer’s billing address
billingAddress.​CountrystringCOUNTRYAlpha-3 ISO country code
rebill.​ExternalRebillstringF_REBILLINGRebilling flag. Only used for non-BluePay generated rebillings to identify the transaction as a rebilling. Set value to "1" for rebill transaction.
rebill.​BluePayRebillstringREBILLING"1" for yes, "0" for no. Rebilling will be managed by BluePay and can be configured using the other rebilling fields below.
rebill.​StartDatestringREB_FIRST_DATEThe date of the first rebilling. Two valid formats as follows:
"YYYY-MM-DD HH:MM:SS" Hours, minutes, and seconds are optional.
"XX UNITS" marked from the time of the transaction. Examples: 10 DAYS, 1 MONTH, 1 YEAR
rebill.​FrequencystringREB_EXPRThe period of time in-between rebillings. "XX UNITS" marked from the time of the transaction. Examples: 10 DAYS, 1 MONTH, 1 YEAR
rebill.​CyclesstringREB_CYCLESNumber of times to rebill. Leaving blank or not sending will cause the rebillings to continue until canceled.
rebill.​AmountintREB_AMOUNTAmount to rebill. Defaults to amount of transaction for rebillings. $10.00 should be sent as 1000
rebill.​IsCreditOrSalestringREB_IS_CREDITField to indicate whether the rebill transaction is a SALE or CREDIT.
The valid values are:
"1" for CREDIT
"0" For SALE (default).

Example Requests​

{
  "gateway": "BluePay",
  "testMode": true,
  "merchantId": "<Your BluePay AccountId>",
  "privateKey": "<Your BluePay Secret Key>",
  "duplicateOverride": true,
  "responseVersion": "5",
  "description": "Wide-ruled notebook paper",
  "amount": 900,
  "orderId": "ABC00001",
  "orderInfo": {
    "purchaseOrderNumber": "ABC00001",
    "invoiceNumber": "ABC00001",
    "customerId": "ABC00001"
  },
  "tax": {
    "amount": 100
  },
  "creditCard": {
    "number": "4111111111111111",
    "expMonth": 6,
    "expYear": 2024,
    "cvv": "123"
  },
  "billingAddress": {
    "phone": "555-555-5555",
    "email": "[email protected]",
    "name": "John Doe",
    "company": "Test Co.",
    "address1": "123 Someplace Lane",
    "address2": "Suite #40A",
    "city": "Edmond",
    "state": "OK",
    "zip": "74100",
    "country": "USA"
  },
  "customerIpAddress": "130.37.201.117"
}

Gateway Response Parameters​

Field NameTypebp10emu MappingNotes
approvalCodestringAUTH_CODEA six-character pseudo-ID from the processing network.
approvedbooleanResultIf the Result field in the GatewayResponse.RawResponse is APPROVED, this field will be true.
providerTransactionCodestringRRNOTransaction ID of the newly run transaction.
Parsing the bp10emu Raw Response

The rawResponse field for BluePay's bp10emu contains a URL-Encoded string of key-values separated by &.' + These fields are in unpredictable orders and values should be read via regex. A suggested regex for finding the values of certain fields: (?\<=([?]\|[&])FIELD_NAME=)([^&]+)
Demo: https://regexr.com/6nhet

Example Responses​

{
  "gatewayResponse": {
    "rawResponse": "/interfaces/wlcatch?TPS_HASH_TYPE=HMAC_SHA512&AMOUNT_TAX=0.00&LEVEL_2_DATA=customer_number%3D%26cust_po%3D%26&ISSUE_DATE=2023-11-30%2013%3A45%3A09.033947&PAYMENT_ACCOUNT=xxxxxxxxxxxx4448&FANCY_STATUS=Approved&ZIP=96592-2764&AUTH_CODE=BARPUD&BACKEND_ID=706282844384&REMOTE_IP=20.37.143.182&TRANS_TYPE=AUTH&STATUS=1&RRNO=200454159023&CVV2_RESULT=_&SOURCE_ID=200454159023&BINDATA=8~N~P~14E00%2000%2000%2000%2000%2000%2000%2000%2000~~~~~~~~N~~~~&AVS_RESULT=1&INVOICE_ID=200454159023&CUSTOMER_CODE=200454159023&FLAGS=T&ORIG_IS_SETTLED=0&F_UNHELD=0&MEMO=Maiores%20dolore%20accusantium%20autem%20vel%20recusandae.&ORDER_ID=200454159023&EMV_APPLICATION=&BANK_NAME=NETWORK%20ONLY&CITY=Ornburgh&F_WILL_CAPTURE=0&ACCOUNT_NAME=DEMO-tokenex&TRANS_ID=200454159023&PAYMENT_TYPE=CREDIT&AVS=1&MODE=TEST&F_CARD_PRESENT=0&CVV2=_&CVV2_STATUS=0&EMV=&CARD_COUNTRY=USA&AMOUNT=9.00&LOGIN_ACCOUNT_ID=100553863405&PROCESSOR_ID=100553863525&OWNER_USER_ID=100553863406&STATE=Hawaii&BP_STAMP=8DD3BAF139458DE9DEB1EC93F0E419301AF80EBE076FC6FE0ACECFB80E1E96B396A346868594DC9F4219843B672158955976F470C178D1DB12A69DAAE78B4B25&F_BYPASS_AUTH=0&F_REBILL_MASTER=0&ADDR1=173%20Antonio%20Pike&COUNTRY=USA&EMV_APPNAME=&COMPANY_NAME=Franecki%2C%20Mertz%20and%20Conroy&MESSAGE=Approved%20Auth&CUST_EMAIL=Mary0%40gmail.com&REBID=&CONNECTED_IP=20.37.143.182&ID=200454159023&Result=APPROVED&ORIGIN=bp10emu&BP_STAMP_DEF=RRNO%20ISSUE_DATE%20Result&EMAIL=Mary0%40gmail.com&CARD_EXPIRE=0324&CARD_TYPE=MC&FRAUD_SCORE=0",
    "gatewayErrors": [],
    "tokenExTransactionCode": "MjAwNDU0MTU5MDIz",
    "approvalCode": "BARPUD",
    "providerTransactionCode": "200454159023",
    "approved": true
  },
  "referenceNumber": "23113013450721664267",
  "success": true,
  "error": "",
  "message": "",
  "thirdPartyStatusCode": "302"
}
Last updated on