Creatre deposit by Token | API PayStar.uk

INFO

This method is used to perform recurring payments after you have obtained the card token. It does not require a PCI DSS certificate.

Thanks to the tokenization of bank cards, you can simplify the payment process for end users. Here's how it works:

Storing Card Data as a Token:

After the first successful payment, we can store your user's card data as a token and provide it to you in the checking payment status request or callbacks.

Response example:

{
    "externalId": "a64104f5-58ff-4c8f-b704-fa28f2d0cf57",
    "orderStatus": "Processing",
    "externalParams": {
        "cardToken": null,
        "cardStorageToken": "7b9fdcbe-10cb-4e06-b8d1-25c4b1cbb081",
        "cardHolder": "JOHN WEAK",
        "cardNumber": "123412******1234"
    }
}

Associating the Token with the User:

You need to save this token and link it to the corresponding user. For subsequent payment initiations, you will need to specify this token in the current payment method/

Request example:

  "amount": 1000,
  "currency": "EUR",
  "externalTransactionId":  "MerchantPaymentId-12345",
  "successRedirectUrl": "http://merch.com/success",
  "failedRedirectUrl": "http://merch.com/failed",
  "processingRedirectUrl": "http://merch.com/processing",
  "additionalFields": [
    {
      "key": "cardStorageToken",
      "value": "7b9fdcbe-10cb-4e06-b8d1-25c4b1cbb081"
    }
  ]
}'

Simplified User Input:

This allows the user to enter only the CVV code on the payment page; other card details will be retrieved from the token.

To make deposit payment please use follow sections:

Create payment (current method): POST token.PayStar.uk/api/v1/integration/deposit-order/

Get status: GET secure.PayStar.uk/api/v1/integration/deposit-order/{externalId}/status

Get status by Callback

Create H2H Deposit with the banking card - Sequence diagram

CURL Example | POST Deposit order

curl --request POST \
 --url https://token.PayStar.uk/api/v1/integration/deposit-order\
 --header 'Authorization: Bearer YOUR TOKEN' \ 
 --header 'Content-Type: application/json' \
 --header 'accept: text/plain' \
 --data '{
  "amount": 100,
  "currency": "USD",
  "externalTransactionId": "MerchantPaymentId-12345",
  "successRedirectUrl": "http://merch.com/success",
  "failedRedirectUrl": "http://merch.com/failed", 
  "processingRedirectUrl": "http://merch.com/processing", 
  "additionalFields": [ 
    {
      "key": "cardStorageToken",
      "value": "7b9fdcbe-10cb-4e06-b8d1-25c4b1cbb081" 
    }
  ]
}'

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://token.PayStar.uk/api/v1/integration/deposit-order/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": 100, "currency": "USD", "externalTransactionId": "MerchID-{{$number.int(min=1)}}", "callbackUrl": "https://merch.com/callbackUrl", "processingRedirectUrl": "https://merch.com/processing", "failedRedirectUrl": "https://merch.com/failed", "successRedirectUrl": "https://merch.com/success", "additionalFields": [ { "key": "cardStorageToken", "value": "7b9fdcbe-10cb-4e06-b8d1-25c4b1cbb081" }, { "key": "payeerIdentifier", "value": "Merch-12345" }, { "key": "email", "value": "Jhon.Wick@Continental-Hotel.com" } ] }'

{ "externalId": "390bb1fb-b837-4480-8302-e39f13b63281", "orderStatus": "Processing", "paymentDetails": { "formUrl": "https://3ds.PayStar.uk?t=ae8b8a5a-f65f-4bb8-97c6-5916d9d02ac4" } }

Deposit H2H - Token

Storing Card Data as a Token:

Associating the Token with the User:

Simplified User Input:

To make deposit payment please use follow sections:

Create H2H Deposit with the banking card - Sequence diagram

CURL Example | POST Deposit order

Request

Responses

Deposit H2H - Token

Storing Card Data as a Token:#

Associating the Token with the User:#

Simplified User Input:#

To make deposit payment please use follow sections:#

Create H2H Deposit with the banking card - Sequence diagram#

CURL Example | POST Deposit order#

Request

Responses

Storing Card Data as a Token:

Associating the Token with the User:

Simplified User Input:

To make deposit payment please use follow sections:

Create H2H Deposit with the banking card - Sequence diagram

CURL Example | POST Deposit order