PartnerCard Payment

From Barion Documentation
Jump to navigation Jump to search

Partner Card Payment

Prerequisits

  • The partner should request a Barion Partner API Key from the Barion team to be able to use the API.

Card registration process


The partner card registration contains three steps.

  1. Card preparation: The partner requests a new card secret from the Barion API. This is stored on the card and used for authentication later. One card number can only be registered once. At this point the card is not attached to any Barion wallet.
  2. Card issueing: The previously registered card can be issued. This means that the card will be attached to a Barion wallett.
  3. Card activation': The owner of the card must choose a PIN number that ensures another factor in the security protocol. This should be registered with the Barion API and must not be stored on the card itself.

Card preparation example

Request

{
   "PartnerKey" : "f776efde-bd50-4755-a233-caa48cdf961f",
   "PAN": "4657 3726 1490"
}

Response

{
  "PrivateCardKey": "b9c8c4c3e660484ca166a32f0ba584cf",
  "Errors": []
}

Card issueing example

Request

{
   "PartnerKey" : "f776efde-bd50-4755-a233-caa48cdf961f",
   "PrivateCardKey": "b9c8c4c3e660484ca166a32f0ba584cf",
   "OwnerLoginName": "[email protected]"
}

Response

{
  "PrivateCardKey": "b9c8c4c3e660484ca166a32f0ba584cf",
  "CardIssueWasSuccessful": true,
  "Errors": []
}

Card activation example

Request

{
   "PartnerKey" : "f776efde-bd50-4755-a233-caa48cdf961f",
   "PrivateCardKey": "b9c8c4c3e660484ca166a32f0ba584cf",
   "CardPin": "1234"
}

Response

{
  "PrivateCardKey": "b9c8c4c3e660484ca166a32f0ba584cf",
  "CardActivationWasSuccessful": true,
  "Errors": []
}

Related API endpoints

TopUp process

TODO

Payment process

First the facilitator