Versions Compared

Version Old Version 10 New Version 11
Changes made by

Sainita Mukherjee

Sainita Mukherjee

Saved on

Key

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

There are two ways to process a credit card: (1) ECOM (which usually requires 3DS), and (2) MOTO (without 3DS).

ECOM payment is the default type and returns… acsform in response for the first time while doing the 3DS authentication. After the authentication, it will return to the user defined URL with encoded transaction ID.

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

Anchorcc-processcc-processCreate 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

user-agentstring
User agent.acceptstring
Acceptaccept-encodingstring
Accept encoding.accept-charsetstring
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...
user-agent: ......
accept: .....
accept-encoding: ....
accept-charset: ....

{
    "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" : "<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>"
}
Response after 3DS authentication

There are two ways to process a credit card: (1) ECOM (which usually requires 3DS), and (2) MOTO (without 3DS).

ECOM payment is the default type and returns… acsform in response for the first time while doing the 3DS authentication. After the authentication, it will return to the user defined URL with encoded transaction ID.

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

user-agentstring
User agent.

acceptstring
Accept

accept-encodingstring
Accept encoding.

accept-charsetstring
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...
user-agent: ......
accept: .....
accept-encoding: ....
accept-charset: ....

{
    "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" : "<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>"
}

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=QkwtTVlVQktTVlV......%3D%3D"
}