Purpose

This method is used by myPOS Web Checkout to allow cardholder to securely store card data which will be used for recurring payments afterwards. The cardholder will remain within the pages of the external application. All needed data (incl. payment card details) will be collected and submitted to myPOS Web Checkout by the external app. The myPOS Web Checkout will return an xml/json with the result.

 

Method properties

Property

Typical value

Type

Required

Description

CardType

1

N(1)

YES

 

PAN

Byte[]

BASE64

YES

 

CardholderName

John Smith

String (30)

YES

 

ExpDate

Byte[]

BASE64

YES

 

CVC

Byte[]

BASE64

YES

 

ECI

6

N(1)

YES

 

AVV

Byte[]

BASE64

Conditional

Conditional.

AVV is required when the card is 3DS enabled.

XID

Byte[]

BASE64

Conditional

Conditional.

AVV is required when the card is 3DS enabled.

CardVerification

2

N(2)

YES

Specify whether the inputted card data to be verified or not before storing. Please refer to Appendix V.

Amount

3.50

Double

Conditional

Conditional. Amount of the transaction. Used in the request if CardVerification = 2.

Currency

EUR

A(3)

Conditional

Conditional. ISO 3-character currency code. Used in the request if CardVerification = 2.

OutputFormat

xml

String

NO

Output format of data. The property can be “xml” or “json”. If it is not specified in the request, the default value is “xml”.

 

Response properties

Property

Typical value

Type

Description

CardToken

1041333312721BC752C1AB7743D0821AA1C9CA09

String (50)

Uniquely generated token of the PAN of the card (returned as a response property of IPCIAPurchase).

PAN

4885

N(4)

Last four digits of the account number (PAN).

ExpDate

1703

N(4)

Card expire date. Format YYMM.

CardType

1

N(1)

Please refer to Appendix IV.

 

Example of the xml response

<IPC_response>
    <IPCmethod>IPCIAStoreCard</IPCmethod>
    <CardToken>70b2214c43814a99f66266c1f1f1e5ec4a8e2a01</CardToken>
    <PAN>4885</PAN>
    <ExpDate>1703</ExpDate>
    <CardType>1</CardType>
    <Status>0</Status>
    <StatusMsg>Success</StatusMsg>   
</IPC_response>