+38 044 290 7 290

I. General description

Dear Partners, welcome to the Google Pay™ integration via the FUIB payment page.
For using the Google Pay™ on your web site, please use the following instructions.

II. Backend API for acquiring

1. Authorization

On the first step, receive a token.

2. Create link

Request

Headers

Parameter name Type Parameter restriction Required Description
authorization string Bearer JWT M Accordingly https://tools.ietf.org/html/rfc6750#section-2.1

Body

Parameter name Type Parameter restriction Required Default value Version Description
external_id string up to 36 characters M External identifier
terminal_id string up to 36 characters O Only for case with several terminals at one merchant
description string up to 1024 characters M Description
short_description string M Short description
merchant_config_id string uuid v4 O Merchant configuration identifier
config_id string uuid v4 O Link configuration ID
hold boolean O false >= 1.10.0 Reserved amount
title string up to 100 characters O Information about organization
lang string UK | RU | EN O Localization
amount integer >= 1 M Amount
commission integer >= 0 O Commission value
options Options O Additional options for a link
params ExtraParams O Additional parameters

Example

{
   "amount": 1000,
   "external_id": "37c3fedf-a424-4eff-9dd1-49a9aa4d37d6",
   "short_url": "http://localhost:8080/resolve/W3mZd",
   "description": "description",
   "short_description": "short description",
   "config_id": "78a75c5f-ce28-411c-bd95-2735b32f0549",
   "client": {
     "source": "EXTERNAL",
     "id": "test"
   }
   "title": "test",
   "options": {
     "ttl": 100,
     "create_short_url": true,
     "backurl": {
       "success": "https://example.com/success",
       "error": "https://example.com/error",
       "cancel": "https://example.com/cancel"
     }
   "params": {
     "shop_url": "http://localhost"
   }
}

Response

Parameter name Type Parameter restriction Required Description
id string M Transaction identifier
url string M URL
short_url string O Short URL
signature string M Signature

Example

{
   "id": "90b20040-f953-4a05-94df-601ad5001b33",
   "url": "http://127.0.0.1:3131?link_id=90b20040-f953-4a05-94df-601ad5001b33&signature=3Ht5y nNXk2f2BiGKH8ddW8G8jy4etRkmnaYhyq8RMxZRhaSDMukgSHCHTq6SxcJ4p1U5iV7qrBGYNzNxNTUrji5mG
   "short_url": "http://localhost:8080/resolve/W3mZd",
   "signature": "3Ht5ynNXk2f2BiGKH8ddW8G8jy4etRkmnaYhyq8RMxZRhaSDMukgSHCHTq6SxcJ4p1U5iV7qrBGYNzNxNTUrji5mGv 7hD38iqmcwLB1VRyZPmrD PpM9SNuP5ByTjZRZu5ojrzHGtq1T4fWu2"
}

3. Link status

Request

Headers

Parameter name Type Parameter restriction Required Description
authorization string Bearer JWT M Accordingly https://tools.ietf.org/html/rfc6750#section-2.1

Parameters

Parameter name Type Parameter restriction Required Description
id string uuid v4 M Link identifier

Example

GET https://innsmouth.payhub.com.ua/frames/links/pga/bb83029c-b80d-44e8-8c35-51b37d7df554
// Headers:
// authorization: Bearer <тут має бути токен авторизації>

Response

Parameter name Type Parameter restriction Required Description
external_id string up to 36 characters M External identifier
frame_id string uuid v4 M Link identifier
params/td> ExtraParams O Extra parameters
status Status M Transaction status
transaction Transaction O Transaction information

Example

{
   "id": "00513757-6246-49c4-82b8-23ff89d370ee",
   "status": "USED",
   "external_id": "b21ab994-a1ac-4934-b5af-1a01d9198408",
   "transaction": {
     "transaction_id": "e6491d9e-a03a-4655-bee4-38fbc24c02cf",
     "status": "PROCESSED"
   }
}

4. Transaction finalization with reserved amount (transaction with state HOLDED)

PUT /frames/links/pga/{id}/complete

Headers

Parameter name Type Parameter restriction Required Description
authorization string Bearer JWT M Accordingly https://tools.ietf.org/html/rfc6750#section-2.1

Parameters

Parameter name Type Parameter restriction Required Description
id string uuid v4 M Link identifier

Body

Parameter name Type Parameter restriction Required Description
transaction_id string uuid v4 M Transaction identifier
amount integer M Amount

Response

Parameter name Type Parameter restriction Required Description
link_id string uuid v4 M Link identifier
transaction_id string up to 36 characters M Transaction identifier
status string M Transaction status

5. Return the reserved funds

Request

Headers

Parameter name Type Parameter restriction Required Description
authorization string Bearer JWT M Accordingly https://tools.ietf.org/html/rfc6750#section-2.1

Parameters

Parameter name Type Parameter restriction Required Description
id string uuid v4 M Link identifier

Body

Parameter name Type Parameter restriction Required Description
transaction_id string uuid v4 M Transaction identifier
amount integer M Amount
comment string M Comment

Response

Parameter name Type Parameter restriction Required Description
link_id string uuid v4 M Link identifier
transaction_id string up to 36 characters M Transaction identifier
status string M Transaction status

6. Addendum

Client

Parameter name Type Description
id string Client id

Status

Parameter name Description
ACTIVE Link is active
EXPIRED The term of link is expired
USED Link is already used
DELETED Link is deleted
FAILED Payment using this link is unsuccessful
PENDING Link is in processing (transaction started)

TransactionStatus

Parameter name Type Parameter restriction Required Description
transaction_id M Transaction id
status Status M Transaction status
cardholder_name string Cardholder name
rrn string Reference number
approval_code string Authorization code
card_from_hash string Card from hash
amount integer Transaction amount
finalized_at string Transaction date
payment_system string Visa | Mastercard Payment system

ExtraParams

Parameter name Type Parameter restriction Description
shop_url string URL Web-link of the online store