Документація

Документація

  • EN
  • UK

›Documentation

Документація

  • Payment Gateway
  • PortmoneDirect
  • Google Pay
  • Apple Pay
  • Structured Link
  • iOS E-com SDK
  • Android E-com SDK
  • Masterpass iOS SDK
  • Masterpass Android SDK
  • H2H JSON ASYNC для PCI DSS
  • Visa/Masterpass Products

Documentation

  • Payment Gateway
  • PortmoneDirect
  • Google Pay
  • Apple Pay
  • Structured Link
  • iOS E-com SDK
  • Android E-com SDK
  • Masterpass iOS SDK
  • Masterpass Android SDK
  • H2H JSON ASYNC for PCI DSS
  • Visa/Masterpass Products

Visa Checkout, mVisa QR and Masterpass payment methods

Glossary

TermDefinition
Merchant, Online Store or PartnerOrganization which has signed a payment acceptance agreement with Portmone.com
Buyer, Client or CustomerA person who visits the Merchant's Online Store in order to learn about the range of goods (services) and to make a purchase
Card, Payment CardPayment cards of Visa, Mastercard international card associations and the National payment system PROSTIR
TokenA unique digital identifier of a card, which is generated during the first operation and then used for quick payment
CVV2/CVC2CVV2 (Card Verification Value 2) is a three-digit card security code that helps to verify legitimacy of a Visa payment card. The Mastercard payment system has similar card security code called CVC2 (Card Validation Code 2)
3-D Secure3-D Secure is a protocol which is used for secure handling of online bank card payments
Issuing Bank (Card Issuing Bank)A bank licensed as a member of a card association (like Visa or Mastercard), that issues and maintains payment cards

1. Visa Checkout

Visa Checkout is a digital wallet by Visa. The service stores payment and shipping information of a customer and allows to make online purchases quickly and securely without entering this information on the merchant's website.

Method: payVisaCheckout

Description: the method is used to transfer funds from the selected payment card from Visa Checkout wallet.

URL for the request: https://www.portmone.com.ua/r3/host-xml/.

Availability and restrictions: the order of parameters in the request should be the same as in the request parameters table below.

Request parameters:

ParameterRequiredTypeDescription
loginYesstringThe Partner login in the Portmone.com system
passwordYesstringThe Partner password in the Portmone.com system
payeeIdYesstringA unique identifier of the Partner in the Portmone.com system
externalClientIdYesstringA unique identifier of the Partner in the Visa Checkout system, Relationship
callIdYesstringThe parameter that Visa returns in the callback after a customer select a card for payment from the wallet
shopOrderNumberNostringThe number of a paid order in the Partner’s system
billAmountYesstringAmount of the payment
descriptionNostringComment to the order/description of payment details
attribute1NostringService field (for additional order information)
attribute2NostringService field (for additional order information). Set “Confirm_COF” if it's a second payment with the same callId
attribute3NostringService field (for additional order information)
attribute4NostringService field (for additional order information)
attribute5NostringLeave empty
emailAddressNostringEmail address of a payer
preauthFlagNostringSets the pre-authorization mode when funds are only blocked on the client’s card, but not actually charged from the client’s account. "Y" – enable pre-authorization mode, "N" – disable pre-authorization mode (the default value is "N")
billCurrencyNostringCurrency of a payment. Default value: UAH
shopSiteIdNostringDigital identifier of a sales channel
cvvUseYesstringThe default value for this method is "N"

An example of request:

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
    <methodName>payVisaCheckout</methodName>
    <params>
        <param>
            <name>login</name>
            <value>SHP_333_V5</value>
        </param>
        <param>
            <name>password</name>
            <value>11111111</value>
        </param>
        <param>
            <name>payeeId</name>
            <value>12720</value>
        </param>
        <param>
            <name>externalClientId</name>
            <value>PORTMONEMERCHANT1</value>
        </param>
        <param>
            <name>callId</name>
            <value>8869359671552386001</value>
        </param>
        <param>
            <name>shopOrderNumber</name>
            <value>test-1</value>
        </param>
        <param>
            <name>billAmount</name>
            <value>1</value>
        </param>
        <param>
            <name>description</name>
            <value>test visa</value>
        </param>
        <param>
            <name>attribute1</name>
            <value></value>
        </param>
        <param>
            <name>attribute2</name>
            <value></value>
        </param>
        <param>
            <name>attribute3</name>
            <value></value>
        </param>
        <param>
            <name>attribute4</name>
            <value></value>
        </param>
        <param>
            <name>attribute5</name>
            <value></value>
        </param>
        <param>
            <name>emailAddress</name>
            <value>[email protected]</value>
        </param>
        <param>
            <name>preauthFlag</name>
            <value>N</value>
        </param>
        <param>
            <name>billCurrency</name>
            <value>UAH</value>
        </param>
        <param>
            <name>shopSiteId</name>
            <value>3437</value>
        </param>
        <param>
            <name>cvvUse</name>
            <value>N</value>
        </param>
    </params>
</methodCall>

Response parameters:

ParameterTypeDescription
shopBillIdstringA unique identifier assigned to each transaction (payment document) in the Portmone.com system
cardMaskstringPayer’s card mask
billAmountstringTransaction amount sent in request
authCodestringBank authorization code
statusstringOrder status. Possible values: PAYED, PREAUTH, REJECTED, CREATED
tokenstringToken value for subsequent payments
mpiFlagstring3DS-authorization flag ("Y" – 3-D Secure check is required, "N" – 3-D Secure check is not required)
verifyFlagstringClient card verification flag (if set to "Y", at the next step the client should enter the VCODE (verification code), received in the SMS-message sent by the card issuing bank)
errorCodestringError code (0 if payment was successful)

An example of successful response:

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>shopBillId</name>
                        <value><string>382712757</string></value>
                    </member>
                    <member>
                        <name>cardMask</name>
                        <value><string>516874******5179</string></value>
                    </member>
                    <member>
                        <name>billAmount</name>
                        <value><string>1</string></value>
                    </member>
                    <member>
                        <name>authCode</name>
                        <value><string>933500</string></value>
                    </member>
                    <member>
                        <name>status</name>
                        <value><string>PAYED</string></value>
                    </member>
                    <member>
                        <name>token</name>
                        <value><string></string></value>
                    </member>
                    <member>
                        <name>mpiFlag</name>
                        <value><string>N</string></value>
                    </member>
                    <member>
                        <name>verifyFlag</name>
                        <value><string>N</string></value>
                    </member>
                    <member>
                        <name>errorCode</name>
                        <value><string>0</string></value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

2. mVisa QR code

mVisa QR is a contactless payment technology using QR codes. When making a purchase with mVisa, a buyer uses a smartphone to scan a QR code that contains merchant's information required for the payment.

Methods

1. Getting QR code

Method: getQrVisa

Description: the method is used to generate mVisa QR code.

URL for the request: https://www.portmone.com.ua/r3/service/.

Availability and restrictions:

No restrictions.

Request parameters:

ParameterRequiredTypeDescription
payeeIdYesstringA unique identifier of the Partner in the Portmone.com system
shopOrderNumberNostringNumber of paid order in the Partner’s system
billAmountYesstringAmount of the payment
descriptionNostringComment to the order/ description of payment details (Latin characters only)
idYesstringID of the request from the Partner to the Portmone.com system

An example of request:

{
    "method": "getQrVisa",
    "params":
    {
        "data":
        {
            "payeeId":"1185",
            "shopOrderNumber":"pay",
            "description":"",
            "billAmount":"5.01"
            }
        },
        "id":"1"
}

Response parameters:

ParameterTypeDescription
qrstringQR string with the encrypted payment data
merchantNamestringMerchant name in the mVisa system
merchantCitystringMerchant city
merchantCountrystringMerchant country
idstringID of the request from the Partner to the Portmone.com system

An example of successful response:

{
    "result": {
        "qr": "000201021640901103000***04pay5",
        "merchantName": "Portmone",
        "merchantCity": "Kiev",
        "merchantCountry": "UA"
    },
    "id": "1"
}

2. Payment by QR code using a token

Method: payByVisaQR

Description: the method is used to pay by previously generated QR using a card token.

URL for the request: https://www.portmone.com.ua/r3/service/.

Availability and restrictions:

No restrictions.

Request parameters:

ParameterRequiredTypeDescription
tokenYesstringPreviously received card token
qrYesstringPreviously generated QR code for the order
idYesstringID of the request from the Partner to the Portmone.com system

An example of request:

{
    "method": "payByVisaQr",
    "params":
    {
        "data":
        {
            "token":"1835303134393836373909***8191D532FA54EB3",
            "qr":"00020102164090***5217750904pay5"
        }
    },
    "id":"1"
}

Response parameters:

ParameterTypeDescription
statusstringOrder status
descriptionstringOrder description
authCodestringBank authorization code
billAmountstringOrder amount
payDatestringPayment date
idstringID of the request from the Partner to the Portmone.com system

An example of successful response:

{
    "result": {
        "status": "PAYED",
        "description": null,
        "authCode": "202084",
        "billAmount": "5.01",
        "payDate": "05.06.2019 18:34:03"
    },
    "id": "1"
}

3. Payment by QR code using a card

To make a payment a client should be redirected to the payment page. For this purpose, a Partner should create a form containing previously generated QR code for the order (qr) and send it by POST method to client’s browser.

An example of HTML-form to call the payment page:

<form action="https://www.portmone.com.ua/gateway/" method="post">
   <input type="hidden" name="qr" value="0002010216409011030000001552046012530398054031.
   55802UA5914MVISA_PORTMONE6004Kiev62170105162400804Test" />
   <input type="hidden" name="method" value="qrvisa" />
</form>

An example of payment page:

An example of payment page

3. Masterpass

Masterpass is a digital wallet by Mastercard. The service stores payment and shipping information for its customers in one safe place, allowing them to make online purchases faster without entering this data on the merchant's website.

Methods

1. qrPaymentMasterpass

Method: qrPaymentMasterpass

Description: the method is used to pay for an order by a card from the Masterpass wallet.

URL for the request: https://www.portmone.com.ua/r3/host-xml/.

Availability and restrictions:

No restrictions.

Request parameters:

ParameterRequiredTypeDescription
order_idYesstringOrder ID in the Masterpass system
qrYesstringMasterpass QR data
panYesstringPayment card number
card_exp_monthYesstringPayer card expiration month (01, 02, …, 12)
card_exp_yearYesstringPayer card expiration year (18, 19, …, 99)

An example of request:

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
    <methodName>qrPaymentMasterpass</methodName>
    <params>
        <param>
            <name>order_id</name>
            <value><string>12440</string></value>
        </param>
        <param>
            <name>qr_string</name>
            <value><string>0002010102125204000054031005802UA5913TestMerchant6004Kiev64200002UK0110333(333)80820017ua.mastercard.www010200020840703265032003265180424111837566040939470845505020181470017ua.mastercard.www011720180727015746000020106304fbb8</string></value>
        </param>
        <param>
            <name>pan</name>
            <value><string>4444333322221111</string></value>
        </param>
        <param>
            <name>card_exp_month</name>
            <value><string>01</string></value>
        </param>
        <param>
            <name>card_exp_year</name>
            <value><string>22</string></value>
        </param>
    </params>
</methodCall>

Response parameters:

ParameterTypeDescription
shop_bill_idstringA unique identifier assigned to each transaction (payment document) in the Portmone.com system
status_codestringError code (0 if payment was successful)
status_msgstringError message
approval_codestringBank authorization code
MDstringParameter which should be sent to acs_url for 3-D Secure check
acs_urlstringThe card issuing bank page URL to which client should be redirected to confirm payment with 3-D Secure
PaReqstringParameter which should be sent to acs_url for 3-D Secure check
is_enrolledstring3DS-authorization flag. If is_enrolled = Y, a client should be redirected to the issuing bank page (acs_url). For this purpose, a merchant should send POST request including acs_url, PaReq and MD parameters and merchant URL to return the response from the bank after passing 3D Secure.
Use the qrPaymentMasterpass3dauth method to complete payment after 3D Secure check is passed

An example of successful response:

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>shop_bill_id</name>
                        <value><string>394708455</string></value>
                    </member>
                    <member>
                        <name>status_code</name>
                        <value><string>0</string></value>
                    </member>
                    <member>
                        <name>status_msg</name>
                        <value><string>Ok</string></value>
                    </member>
                    <member>
                        <name>approval_code</name>
                        <value><string>021284</string></value>
                    </member>
                </struct>
            </value>
        </param>
    </params>

An example of response if 3-D Secure check is required:

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>shop_bill_id</name>
                        <value><string>394708455</string></value>
                    </member>
                    <member>
                        <name>status_msg</name>
                        <value><string>OK</string></value>
                    </member>
                    <member>
                        <name>status_code</name>
                        <value><string>0</string></value>
                    </member>
                    <member>
                        <name>MD</name>
                        <value><string>151630559</string></value>
                    </member>
                    <member>
                        <name>acs_url</name>
                        <value><string>https://acs.portmone.com.ua/mc/</string></value>
                    </member>
                    <member>
                        <name>PaReq</name><value>
                        <string>eJxVUe1ygjAQfBWH/yUxJHw4Rxxa2qnToThVH4CBjNIKKB8V+/S9IGr7IzO3d5fdZBfmfbGffKu6yavSN6YmNSaqTKssL7e+sVm/PLjGXMJ6VysVrlTa1UpCpJom2apJnvnGMvlQx6mwmM2FZzmUMW5xl9vUY57wuO3ZQliGhGWAexJGJYlCJgNyhUhZp7ukbCUk6fFx8S4Fd23hAhkhFKpehNJGNuFwIBcIZVIo+RZHcWhuAiADhLTqyrY+S5fi4hVAV+/lrm0PM0K+qqLKzC4BoptA7uLLTlcNkvR5JqMwOOHp4zCwos/0FK0ojcOIRz/PPhC9AVnSKsno1KUOsyeMzYQ7Ew6QoQ9JodWlZVKKP7kAOGiNYJzowd8GoMM1BnCWnoujGwLVH6pS4Qa6dquB3B/89Kq9S1u0hXkW5xiGxZg2cOhpghx9YPjYgUEDIPoWGbMhY65Y/cv7Fx8/rt0=</string></value>
                    </member>
                    <member>
                        <name>is_enrolled</name>
                        <value><string>Y</string></value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

2. qrPaymentMasterpass3dauth

Method: qrPaymentMasterpass3dauth

Description: the method is used to complete payment by a card from the Masterpass wallet after 3-D Secure check.

URL for the request: https://www.portmone.com.ua/r3/host-xml/.

Availability and restrictions:

No restrictions.

Request parameters:

ParameterRequiredTypeDescription
shop_bill_idYesstringA unique identifier assigned to each transaction (payment document) in the Portmone.com system
paresYesstringThe PaRes value received from the bank to your URL
mdYesstringThe MD value received from the bank to your URL

An example of request:

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
    <methodName>qrPaymentMasterpass3dauth</methodName>
    <params>
        <param>
            <name>shop_bill_id</name>
            <value><string>394708455</string></value>
        </param>
        <param>
            <name>pares</name>
            <value><string>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</string></value>
        </param>
        <param>
            <name>md</name>
            <value><string>151630559</string></value>
        </param>
    </params>
</methodCall>

Response parameters:

ParameterTypeDescription
shop_bill_idstringA unique identifier assigned to each transaction (payment document) in the Portmone.com system
status_codestringError code (0 if payment was successful)
status_msgstringError message
approval_codestringBank authorization code

An example of successful response:

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>shop_bill_id</name>
                        <value><string>394708455</string></value>
                    </member>
                    <member>
                        <name>status_code</name>
                        <value><string>0</string></value>
                    </member>
                    <member>
                        <name>status_msg</name>
                        <value><string>Ok</string></value>
                    </member>
                    <member>
                        <name>approval_code</name>
                        <value><string>021284</string></value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>
← H2H JSON ASYNC for PCI DSS
  • Glossary
  • 1. Visa Checkout
  • 2. mVisa QR code
    • Methods
    • 1. Getting QR code
    • 2. Payment by QR code using a token
    • 3. Payment by QR code using a card
  • 3. Masterpass
    • Methods
    • 1. qrPaymentMasterpass
    • 2. qrPaymentMasterpass3dauth
Copyright © 2022 Portmone.com