Authorize

Here you can make an authorize request

Field NameLenTypeReqVerComments
methodN/AAlp-NumYes1.2authorize
fromEmailN/AAlp-NumYes1.2The email associated with the account from which the authorize is made
merchantAccountIdN/ANumYes1.2Acquiring Merchant ID
amountN/ANumYes1.2The amount of the authorize transaction
currencyN/AAlpYes1.2The amount currency(e.g. USD)
referenceIdN/AAlp-NumYes1.2Your internal identification
cardNumber16NumYes1.2The number of the card
cardExpiryMonth2NumYes1.2Card expiry month
cardExpiryYear4NumYes1.2Card expiry year
cardVerificationNumber3NumYes1.2Card Verification Number (CVV)
cardType1NumYes1.2Card Type
1 = Card type 1
2 = Card type 2
billingFirstNameN/AAlpYes1.2Customer's First Name
billingLastNameN/AAlpYes1.2Customer's Last Name
billingMiddleNameN/AAlp--1.2Customer's Middle Name
billingIdnN/AAlp-Num--1.2Identity Verification Number
billingCountry2Alp-NumYes1.2Billing Country - two letters country code (ISO Char 2 Code)
billingState2/3Alp-NumYes1.2Billing State - two/tree letters state / province / county code (ISO 3166-2)
billingCityN/AAlp-NumYes1.2Billing City
billingStreetNameN/AAlp-NumYes1.2Billing Street Name
billingStreetNumberN/AAlp-NumYes1.2Billing Street Number
billingBuildingN/AAlp-Num--1.2Billing Building
billingEntranceN/AAlp-Num--1.2Billing Entrance
billingFloorN/AAlp-Num--1.2Billing Floor
billingApartmentN/AAlp-Num--1.2Billing Apartment
billingDistrictN/AAlp-Num--1.2Billing District
billingZipN/AAlp-NumYes1.2Billing Zip (Postal Code)
billingPhoneN/ANumYes1.2Billing Phone
billingEmailN/AAlp-Num--1.2Billing Email
billingCompanyNameN/AAlp-Num--1.2Company that acquires the goods or services
billingCompanyRegistrationNumberN/AAlp-Num--1.2The company’s unique registration code
billingCompanyTaxNumberN/AAlp-Num--1.2Company registration number with Trade Register
billingCompanyBankNameN/AAlp-Num--1.2Customer’s bank
billingCompanyBankAccountN/AAlp-Num--1.2Customer’s bank account
shippingFirstNameN/AAlp-Num--1.2Shipping First Name
shippingLastNameN/AAlp-Num--1.2Shipping Last Name
shippingMiddleNameN/AAlp-Num--1.2Shipping Middle Name
shippingCompanyNameN/AAlp-Num--1.2Shipping Company Name
shippingCountry2Alp-Num--1.2Shipping Country - two letters country code (ISO Char 2 Code)
shippingState2/3Alp-Num--1.2Shipping State - two/tree letters state / province / county code (ISO 3166-2)
shippingCityN/AAlp-Num--1.2Shipping City
shippingStreetNameN/AAlp-NumYes1.2Shipping Street Name
shippingStreetNumberN/AAlp-NumYes1.2Shipping Street Number
shippingBuildingN/AAlp-Num--1.2Shipping Building
shippingEntranceN/AAlp-Num--1.2Shipping District
shippingFloorN/AAlp-Num--1.2Shipping Floor
shippingApartmentN/AAlp-Num--1.2Shipping Apartment
shippingDistrictN/AAlp-Num--1.2Shipping Address
shippingZipN/AAlp-Num--1.2Shipping Zip (Postal Code)
shippingPhoneN/AAlp-Num--1.2Shipping Phone
keyN/AAlp-NumYes1.2MD5(sharedSecret + merchantAccountId + amount + currency + referenceId + cardNumber + cardExpiryMonth + cardExpiryYear + cardVerificationNumber + cardType + billingFirstName + billingLastName + billingMiddleName + billingIdn + billingCountry + billingState + billingCity + billingStreetName + billingStreetNumber + billingBuilding + billingEntrance + billingFloor + billingApartment + billingDistrict + billingZip + billingPhone + billingEmail + billingCompanyName + billingCompanyRegistrationNumber + billingCompanyTaxNumber + billingCompanyBankName + billingCompanyBankAccount + shippingFirstName + shippingLastName + shippingMiddleName + shippingCompanyName + shippingCountry + shippingState + shippingCity + shippingAddress + shippingZip + shippingPhone )

This request is responded by a message with the following content:

Field NameLenTypeMdtVerComments
ResponseCodeN/AAlp-NumYes1.2The response code; 00 = Success;
ResponseDescriptionN/AAlp-NumYes1.2Human readable response
FeeN/ARealYes1.2Fee for the current transaction
TransactionIdN/ANumYes1.2The transaction ID if successfully, otherwise not specified
ReferenceIdN/ANumYes1.2Your internal identification
StatusN/ANumYes1.2The authorization status
2 = Active
4 = Canceled
23 = Pending
25 = Failed
40 = Authorized

Request Sample:

https://secure.paxum.com/payment/api/paymentAPI.php
POST
method=authorize&fromEmail=payer%40domain.com&merchantAccountId=123456&amount=0.08&currency=USD&referenceId=225845&cardNumber=1234567890123456&cardExpiryMonth=07&cardExpiryYear=13&cardVerificationNumber=0&billingFirstName=firstName&billingLastName=LastName&billingMiddleName=middleName&billingIdn=123456798&billingCountry=US&billingState=NY&billingCity=New+York&billingStreetName=Fifth+Ave&billingStreetNumber=350&billingBuilding=&billingEntrance=&billingFloor=&billingApartment=&billingDistrict=&billingZip=123456&billingPhone=0123456789&billingEmail=payeer%40domain.com&billingCompanyName=companyName&billingCompanyRegistrationNumber=13456798&billingCompanyTaxNumber=132456789&billingCompanyBankName=bankName&billingCompanyBankAccount=13246589764131141&shippingFirstName=sFirstName&shippingLastName=sLastName&shippingMiddleName=sMiddleName&shippingCompanyName=sCompanyName&shippingCountry=sCountry&shippingState=sState&shippingCity=sCity&shippingStreetName=sStreetName&shippingStreetNumber=sStreetNumber&shippingBuilding=sStreetBuilding&shippingEntrance=sStreetEntrance&shippingFloor=sStreetFloor&shippingApartment=sStreetApartment&shippingDistrict=sStreetDistrict&shippingZip=sZip&shippingPhone=0123456798&key=bbd2204f2f85a026667df4e25e545e78

Response Sample

<?xml version="1.0"?>
<Response>
    <Environment>PRODUCTION</Environment>
    <Method>riskRating</Method>
    <ResponseCode>00</ResponseCode>
    <ResponseDescription>Approved or Completed Successfully</ResponseDescription>
    <TransactionId>MER616GV</TransactionId>
    <Verification>
    <RiskScore>49.39</RiskScore>
    <Distance>6891</Distance>
    <BinName>3</BinName>
    <BinMatch>0</BinMatch>
    <BinCountry>US</BinCountry>
    <CountryCode>BR</CountryCode>
    <CountryMatch>0</CountryMatch>
    <ProxyScore>0</ProxyScore>
    <CarderEmail>0</CarderEmail>
    </Verification>
</Response>

Response Sample

http://www.domain.com/notificationURL
POST
responseCode=00&transactionId=23646236&statusId=37&referenceId=225845

Working Sample(s):

authorize.php