Versions Compared

Version Old Version 13 New Version 14
Changes made by

Mohsin Shah

Mohsin Shah

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

There are two ways to process a credit card: (1)

  1. ECOM (which usually requires 3DS)

, and (2) MOTO (without 3DS).ECOM


  1. ECOM payment is the default type and

returns… acsform in response for the first time while doing

  1. returns an acsform, which is a HTML from used to perform the 3DS authentication. This

acsform need to

  1. HTML form should be added to a

view

  1. page and sent to

redirect

  1. the

user in 3DS authentication page. After the authentication, it will return to the user defined URL with

  1. user. The user will complete the 3DS form and submit. After submission, the user will be returned to the predefined return URL with an encoded transaction ID.

  2. MOTO(without 3DS).
    MOTO payment is … Process the payment and return to the user defined URL with encoded transaction ID.

Resources

POST /v1/pay/cc/process for ECOM
POST /v1/pay/cc/process for MOTO

Anchor
cc-process-ecom
cc-process-ecom

Create Credit Card Payment for ECOM

POST /v1/pay/cc/process

info

In 3DS authentication , you need to pass the following additional information in header.

Headers

userUser-agentAgentstring
User agent.

acceptAcceptstring
Accept

acceptAccept-encodingEncodingstring
Accept encoding.

acceptAccept-charsetCharsetstring
Accept charset.

Attributes

payment_intentstring
Payment intent token.

paymentTokenstring
Payment token generated from Create Payment Token request.

typestring
Type 1 is ECOM payment and type 2 is MOTO.

raw_amountfloat
Payment amount.

customer_emailstring
Customer email.

customer_namestring
Customer name.

transaction_uniquestring
Transaction unique.

device_timezoneinteger
Device timezone value which can be fetched using javascript. This value is required in 3DS.

device_capabilitiesstring
Device capabilities which can be fetched using javascript. This value is required in 3DS.

device_accept_languagestring
Device accept language which can be fetched using javascript. This value is required in 3DS.

device_screen_resolutionstring
Device accept language which can be fetched using javascript. This value is required in 3DS.

remote_addressstring
Remote address which can be fetched using javascript. This value is required in 3DS.

Request

Code Block
POST https://secure.blinkpayment.co.uk/api/v1/pay/cc/process
Content-Type: application/json
Authentication: Bearer eyJ0eXAiOiJKV1QiLCJhbG...
userUser-agentAgent: ......
acceptAccept: .....
acceptAccept-encodingEncoding: ....
acceptAccept-charsetCharset: ....

{
    "payment_intent": "pi_Swhc84aSLtUGppvPARX...",
    "paymentToken": "eyJwYXltZW50VG9rZW4iOns...",
    "type": 1,
    "raw_amount": 1.1,
    "customer_email": "random@email.com",
    "customer_name": "A Smith",
    "transaction_unique": "PHnRNzjUw...",
    "device_timezone" : "-3**",
    "device_capabilities" : "java**",
    "device_accept_language" : "en-G*",
    "device_screen_resolution" : "1360x7****",
    "remote_address" : "10********"
}

Response before 3DS authentication

Code Block{ "acsform" : "

Code Block
{
   "acsform" : "<form id="form3ds22" method="post" action="https://acs.********"><input type="hidden" name="creq" value="********">
                <input type="hidden" name="threeDSPageSessions[427**************][bfreq]" value="*******">
                <input type="hidden" name="threeDSPageSessions[427**************][threeDSRef]" value="****">
                <input id="btnSubmit" type="submit" class="button expanded btn btn-primary" value="Process Payment">
                </form>"
}

HTML Form

Code Block
<!DOCTYPE html>
<html>
<head>
  <title>Page Title</title>
</head>

<body>
  <h1>3DS</h1>
  <div>
    <form id="form3ds22" method="post" action="https://acs.********"><input type="hidden" name="creq" value="********">
    
           <input type="hidden" name="threeDSPageSessions[427**************][bfreq]" value="*******">
         
      <input type="hidden" name="threeDSPageSessions[427**************][threeDSRef]" value="****">

               <input id="btnSubmit" type="submit" class="button expanded btn btn-primary" value="Process Payment">
    </form>
          </div>
</body>
</form>"
}html>

Response after 3DS authentication

Code Block
{
    "url": "https://api-demo-php.blinkpayment.co.uk/return?res=QkwtTVlV......%3D%3D"
}

Anchor
cc-process-moto
cc-process-moto

Create Credit Card Payment for MOTO

POST /v1/pay/cc/process

Attributes

payment_intentstring
Payment intent token.

paymentTokenstring
Payment token generated from Create Payment Token request.

typestring
Type 1 is ECOM payment and type 2 is MOTO.

raw_amountfloat
Payment amount.

customer_emailstring
Customer email.

customer_namestring
Customer name.

transaction_uniquestring
Transaction unique.

Request

Code Block
POST https://secure.blinkpayment.co.uk/api/v1/pay/cc/process
Content-Type: application/json
Authentication: Bearer eyJ0eXAiOiJKV1QiLCJhbG...

{
    "payment_intent": "pi_Swhc84aSLtUGppvPARX...",
    "paymentToken": "eyJwYXltZW50VG9rZW4iOns...",
    "type": 2,
    "raw_amount": 1.1,
    "customer_email": "random@email.com",
    "customer_name": "A Smith",
    "transaction_unique": "PHnRNzjUw..."
}

Response

Code Block
{
    "url": "https://api-demo-php.blinkpayment.co.uk/return?res=QktTVlV......%3D%3D"
}