Skip to content

Card Unbinding SNAP

This feature will be used by merchants to cancel VA.

NameAPI Card Registration Unbinding
Service Code05
Path../{version}/registration-card-unbind
Version1.0
HTTP MethodPOST
Type FormatJSON

Request Body

FieldTypeMandatoryLengthDescription
partnerReferenceNoStringO64Transaction identifier on service consumer system
tokenStringM128This is an alphanumeric field which contains the payment token used in a transaction. This field is used during setting token daily limit, purchase, and delete token. This token represents the token number of the card or token.
bankCardNoStringO19Card number of the cardholder
typeStringO20Request type. Value: unsubscribe
additionalInfoObjectOAdditional information
additionalInfo.remarksStringOUnbind description

Sample request:

sh
--header 'X-TIMESTAMP: 2020-12-18T10:55:00+07:00' \
--header 'X-SIGNATURE: NKaLTZFZv394MMNfeiKp0WKjq+Usthwja2L0JGrE+2z7x5KAWJoD85xL+4+TsOFWcf+E6lb3L4cKYVloUwEgrWAjiwMeYQ7oG2kw2HqoObzjc6bOdHQa31UkQaQUeazDaCc3coPNad6zAsBX0tmnx51WZJfsVkFEzjsdVrBnPgWWL0tE3YUqa52BSKaS2/DjX+XToYcXCmU40nnzljt6L+d9zqNLH6kDOnKwCWJF54raQhvNLq8P4jAWOMS3dBdtPC7dOwclJwsb2YTyXupsgm6GhHS8KVqWXY/qgIiJXRPgbs+ZKmAeGpSs0LenQ0OnglsEma5SYmDaNpqKLcC5xg==' \
--header 'X-Partner-Id: IFP2024078155' \
--header 'CHANNEL-ID: DD003' \
--header 'X-EXTERNAL-ID: 77349314177349' \
--header 'X-TRACE-ID: 1' \
--header 'X-PUBLIC-ID: ipaaldkjf' \
--header 'Content-Type: application/json' \
--data '{
    "partnerReferenceNo": "QA-20240715-004",
    "additionalInfo": {
        "remarks": "testing QA"
    },
    "bankCardNo": "5221841065565045",
    "token": "card_.eyJpYXQiOjE3MjEwMzUyMDksImlzcyI6IkJhbmsgQlJJIC0gRENFIiwianRpIjoiYWVlZThlOWYtNGU1NC00MDU2LThlZDItYTA5YjRiMDRiOWRjIiwicGFydG5lcklkIjoi77-9Iiwic2VydmljZU5hbWUiOiJERF9FWFRFUk5BTF9TRVJWSUNFIn0.IKXvBjoqFYJtvvQ-1YiKtVHi-p4e7fIFehmN00kq9YSrU2TdlPKbn36GoYBj1_JxeqGpd7OcGV7sX2euVK39eMf_3MbVZ-SNYkJxRPHk1KLVq9ZK3CEaoRkfF_Dg5QTaE4o1zi786SVGuGC3p3MvyboGPzqevJGyoYaI_b4YgBamlF2YWKXUdqTYGnkmrdM56G7MkQ6v4D3RyDGf0CNd2faVkgVOkWHR-XJYwfFFruKg_S6841toQT-_uEjX8hfaWMxNs3jX2QCEIHeYVWGvoPfmTI89YHtUMeqkMgQJZcU8cVaQfpA47SbBSZDdk6hMDCffX6b5jpWoWpJ6NMUIug",
    "type": "unsubscribe"
}'

Response Body

FieldTypeMandatoryLengthDescription
responseCodeStringM7Response code
responseMessageStringM150Response Description
responseMessageStringM150Response description
referenceNoStringO64Transaction identifier on service provider system. Must be filled upon successful transaction
partnerReferenceNoStringO64Transaction identifier on service consumer system
unsubscribeDateDatetimeOUnsubscribe date. Format: ISO 8601
additionalInfoObjectOAdditional information
additionalInfo.remarkStringOUnbind description

Sample Response:

json
{
  "additionalInfo": {
    "remark": "testing QA"
  },
  "partnerReferenceNo": "QA-20240715-004",
  "referenceNo": "0190b5b1dcb17cbca8d9ca99f2587a5b",
  "responseCode": "2000500",
  "responseMessage": "Successful",
  "unsubscribeDate": "2024-07-15T16:20:51+07:00"
}

iFortepay API Documentation