Add Card

To add another card on the same subscription ID, you will just have to replace one request parameter in the Payment Key Request explained in Payment API Flow.

You will follow the normal API Flow i.e. :

1. Authentication Request:

The Authentication request is an elementary step you should do before dealing with any of Accept's APIs.
It is a post request with a JSON object that contains your api_key found in your dashboard - Profile tab.

URL: https://accept.paymob.com/api/auth/tokens

Method: POST

Source: Merchant's server

Recipient: Accept's server

Content-Type: JSON

Example request data:

{
    "api_key": "ZXlKaGJHY2lPaUpJVXpVe..."
}

Parameter	Required	Description
api_key	Yes	It is a unique identifier for the merchant which used to authenticate your requests calling any of Accept's API.

Example response:

{
    "token": "ZXlKaGJHY2lPaUpJVXpVeE1pSXNJ..."
}

Parameter	Required for the next request	Description
token	Yes	Authentication token, which is valid for one hour from the creation time.

2. Order Registration API

At this step, you will register an order to Accept's database, so that you can pay for it later using a transaction.
Order ID will be the identifier that you will use to link the transaction(s) performed to your system, as one order can have more than one transaction.

URL: https://accept.paymob.com/api/ecommerce/orders

Method: POST

Source: Merchant's server

Recipient: Accept's server

Content-Type: JSON

Example request data:

{
  "auth_token":  "ZXlKaGlPaUpJVXpVeE1pSX1Y0NJmV5Sn...",
  "delivery_needed": "false",
  "amount_cents": "100",
  "currency": "EGP",
  "merchant_order_id": 5,
  "items": [
    {
        "name": "ASC1515",
        "amount_cents": "500000",
        "description": "Smart Watch",
        "quantity": "1"
    },
    { 
        "name": "ERT6565",
        "amount_cents": "200000",
        "description": "Power Bank",
        "quantity": "1"
    }
    ],
  "shipping_data": {
    "apartment": "803", 
    "email": "[email protected]", 
    "floor": "42", 
    "first_name": "Clifford", 
    "street": "Ethan Land", 
    "building": "8028", 
    "phone_number": "+86(8)9135210487", 
    "postal_code": "01898", 
     "extra_description": "8 Ram , 128 Giga",
    "city": "Jaskolskiburgh", 
    "country": "CR", 
    "last_name": "Nicolas", 
    "state": "Utah"
  },
    "shipping_details": {
        "notes" : " test",
        "number_of_packages": 1,
        "weight" : 1,
        "weight_unit" : "Kilogram",
        "length" : 1,
        "width" :1,
        "height" :1,
        "contents" : "product of some sorts"
    }
}

Parameter	Required	Description
auth_token	Yes	The authentication token obtained from Step 1
delivery_needed	Yes	Set it to be true if your order needs to be delivered by Accept's product delivery services.
amount_cents	Yes	The price of the order is in cents.
merchant_order_id	No	A unique alpha-numeric value, for example: "E6RR3". Discard it from the request if you don't need it.
items	Yes	list of objects contains the contents of the order if it exists, send it as an empty array if it is not available. However, Mandatory for Souhoula and GET_GO payment methods.
shipping_data	No	Mandatory if your order needs to be delivered, otherwise you can delete the whole object.
shipping_details	No	Mandatory if your order needs to be delivered, otherwise you can delete the whole object.

Example response:

{
  "id": 103,
  "created_at": "2017-01-10T05:41:15.700814Z",
  "delivery_needed": "false",
  "merchant": {
      "id": 28,
      "created_at": "2016-11-17T15:02:53.646620Z",
      "phones": [
          "011111111111",
          "012324151432"
      ],
      "company_emails": [
          "[email protected]",
          "[email protected]"
      ],
      "company_name": "Wuckert, Zieme and Dach",
      "state": "Oklahoma",
      "country": "Oman",
      "city": "Port Arvillachester",
      "postal_code": "83372",
      "street": "Walker Ramp"
  },
  "collector": "null",
  "amount_cents": 100,
  "shipping_data": {
      "id": 80,
      "first_name": "test",
      "last_name": "account",
      "street": "example",
      "building": "6",
      "floor": "4",
      "apartment": "404",
      "city": "cairo",
      "state": "egypt",
      "country": "egypt",
      "email": "[email protected]",
      "phone_number": "00201000212058",
      "postal_code": "123456",
      "extra_description": "test asdf",
      "shipping_method": "EM",
      "order_id": 103,
      "order": 103
  },
  "currency": "EGP",
  "is_payment_locked": "false",
  "merchant_order_id": "null",
  "wallet_notification": "null",
  "paid_amount_cents": 0,
  "items": []
}

Parameter	Required for the next request	Description
id	Yes	This is the ID of your order in Accept's database, so you can use this reference to perform any action to this Order.

3. Payment Key Request

At this step, you have to pass "subscriptionv2_id" with your integration ID so that this transaction would be considered the first transaction/Initial transaction as well as, this card will also be added as a secondary card with the previously added card

you will obtain a payment_key token in response to this API. This key will be used to authenticate your payment request. It will be also used for verifying your transaction request metadata.

URL: https://accept.paymob.com/api/acceptance/payment_keys

Method: POST

Source: Merchant's server

Recipient: Accept's server

Content-Type: JSON

Example request data:

{
  "auth_token": "ZXlKaGlPaUpJVXpVeE1pSX1Y0NJmV5Sn...",
  "amount_cents": "100", 
  "expiration": 3600, 
  "order_id": "103",
  "billing_data": {
    "apartment": "803", 
    "email": "[email protected]", 
    "floor": "42", 
    "first_name": "Clifford", 
    "street": "Ethan Land", 
    "building": "8028", 
    "phone_number": "+86(8)9135210487", 
    "shipping_method": "PKG", 
    "postal_code": "01898", 
    "city": "Jaskolskiburgh", 
    "country": "CR", 
    "last_name": "Nicolas", 
    "state": "Utah"
  }, 
  "currency": "EGP", 
  "integration_id": 1,
  "subscriptionv2_id":4,
  "lock_order_when_paid": "false"
}

Parameter	Description	Mandatory
subscriptionv2_id	A subscription ID will be passed against this parameter where the additional card needs to be added.	Yes