API Reference

Naspay Merchant API

Overview

The Naspay API uses HTTP methods and a RESTful endpoint structure. The API authorization framework is OAuth 2.0. You format requests in JSON and the APIs return JSON-formatted responses.

Version information

Version : 2018-08-28

Contact information

Contact : Naspay Support Team
Contact Email : support@naspay.com

License information

License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : https://naspay.com/terms

URI scheme

Host : naspay.com
Schemes : HTTPS

Tags

  • auth : OAuth 2.0 Server API
  • payments : Merchant Payments API
  • payouts : Merchant Payouts API
  • backoffice : Merchant Backoffice API

Security

basicSecurity

Get an access token by using the OAuth 2.0 client_credentials token grant type with your terminalKey:terminalSecret as your Basic Auth credentials

Type : basic

oauth2Security

With each API call, you must set request headers including an OAuth 2.0 access token

Type : oauth2
Flow : application
Token URL : https://naspay.com/auth/token

Name Description
transactions Operations with transactions
payouts Payouts
kyc Customers registration and identification
customerProfiles Customers profiles management

Paths

POST /api/v1/cards/verify

Description

Card Verify

Body parameter

Request to verify card

Name : body
Flags : required
Type : CardVerifyRequest

Responses

HTTP Code Description Schema
201 Card verified. CardVerifyResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
422 Operation is declined ErrorResponse

Consumes

  • application/json

Produces

  • application/json

Tags

  • cards

Security

Type Name Scopes
oauth2 oauth2Security cards

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/customers/

Description

Customer profile - Create Customer

Body parameter

Customer profile - Request to create a Customer

Name : body
Flags : required
Type : Customer

Responses

HTTP Code Description Schema
201 Customer profile - Customer created. CustomerResponse
400 Invalid input CustomerError
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
409 Customer with the same details is already registered CustomerError

Consumes

  • application/json

Produces

  • application/json

Tags

  • customerProfile

Security

Type Name Scopes
oauth2 oauth2Security customerProfile

Example HTTP request

Request body

{
  "email" : "john@example.com",
  "phone" : "(123) 456-7890",
  "merchantCustomerId" : "cus-123456",
  "locale" : "en",
  "ip" : "99.33.51.102",
  "userAgent" : "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/56.0.2924.75 Mobile/14E5239e Safari/602.1"
}

Example HTTP response

Response 400

{
  "status" : "error",
  "code" : 400,
  "message" : "Bad Request"
}
Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 409

{
  "status" : "error",
  "code" : 409,
  "message" : "Customer is already registered"
}

POST /api/v1/customers/{id}

Description

Customer profile - Update Customer

Parameters

Type Name Description Schema
Path id
required
Merchant Customer Id string

Body parameter

Customer profile - Request to update Customer

Name : body
Flags : required
Type : Customer

Responses

HTTP Code Description Schema
200 Customer profile - Customer updated. CustomerResponse
400 Invalid input CustomerError
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Customer not found CustomerError

Consumes

  • application/json

Produces

  • application/json

Tags

  • customerProfile

Security

Type Name Scopes
oauth2 oauth2Security customerProfile

Example HTTP request

Request body

{
  "email" : "john@example.com",
  "phone" : "(123) 456-7890",
  "merchantCustomerId" : "cus-123456",
  "locale" : "en",
  "ip" : "99.33.51.102",
  "userAgent" : "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/56.0.2924.75 Mobile/14E5239e Safari/602.1"
}

Example HTTP response

Response 400

{
  "status" : "error",
  "code" : 400,
  "message" : "Bad Request"
}
Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Customer Not Found"
}

GET /api/v1/customers/{id}

Description

Customer profile - Find Customer

Parameters

Type Name Description Schema
Path id
required
Merchant Customer Id string

Responses

HTTP Code Description Schema
200 Customer profile - Customer details. CustomerResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Customer not found CustomerError

Consumes

  • application/json

Produces

  • application/json

Tags

  • customerProfile

Security

Type Name Scopes
oauth2 oauth2Security customerProfile

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Customer Not Found"
}

POST /api/v1/kyc/checkGamblingRegistry

Description

KYC Register Checks - Creates a Check Gambling Registry transaction. It verifies if the customer is registered in a Gambling related registry

Body parameter

Mandatory parameters: countryCode, firstName, lastName. Optional parameters: i.e. dateOfBirth

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Check Gambling Registry transaction processed. Response fields: customer.matchDetails.isMatch and customer.matchDetails.data KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/checkWatchList

Description

KYC PEP and Sanctions Check - Creates a Check Watch List transaction. It verifies if the customer is PEP (politically exposed person) and if he has any sanctions

Body parameter

Mandatory parameters: countryCode, firstName, lastName. Optional parameters: i.e. dateOfBirth

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Check Watch List transaction processed. Response fields: customer.pepInfo and customer.sanctionsInfo KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/login

Description

KYC - Creates a Login transaction

Body parameter

KYC - Request to create a Login transaction

Name : body
Flags : required
Type : KYCLoginRequest

Responses

HTTP Code Description Schema
201 KYC - Login transaction created. KYCRedirectResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/lookupPerson

Description

KYC Register Checks - Creates a Lookup Person transaction

Body parameter

Mandatory parameters: countryCode, personalNumber. Optional parameters: i.e. phone

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Lookup Person transaction processed. Response fields: all customer, customer.address and customer.matchDetails.isMatch fields KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/matchId

Description

KYC Register Checks - Creates a Match Ids transaction: i.e. try to match a ‘national personal number’ with a ‘registry person id’ to understand if they refer to the same customer

Body parameter

Mandatory parameters: countryCode, extSystemId1, extSystemId2

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Match Ids transaction processed. Response fields: customer.matchDetails.isMatch KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/register

Description

KYC - Creates a Registration transaction

Body parameter

KYC - Request to create a Registration transaction

Name : body
Flags : required
Type : KYCRegisterRequest

Responses

HTTP Code Description Schema
201 KYC - Registration transaction created. KYCRedirectResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/searchPerson

Description

KYC Register Checks - Creates a Search Person transaction

Body parameter

Mandatory parameters: countryCode, firstName, lastName. Optional parameters: i.e. phone, dateOfBirth, personalNumber, city

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Search Person transaction processed. Response fields: customers (a list of customer entities) KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/validateAddress

Description

KYC Register Checks - Creates a Validate Address transaction

Body parameter

Mandatory parameters: addressLine1, postalCode, city, countryCode. Optional parameters: i.e. firstName, lastName, dateOfBirth, mobileNumber, personalNumber

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Validate Address transaction processed. Response fields: address.matchDetails.level, address.matchDetails.data KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/kyc/validatePerson

Description

KYC Register Checks - Creates a Validate Person transaction

Body parameter

Mandatory parameters: addressLine1, postalCode, city, countryCode. Optional parameters: i.e. firstName, lastName, dateOfBirth, phone, personalNumber

Name : body
Flags : required
Type : KYCRegisterChecksRequest

Responses

HTTP Code Description Schema
200 KYC - Validate Person transaction processed. Response fields: customer.matchDetails.level, customer.matchDetails.data KYCResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Consumes

  • application/json

Produces

  • application/json

Tags

  • kyc

Security

Type Name Scopes
oauth2 oauth2Security kyc

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

POST /api/v1/payouts

Description

Creates new payout and optionally executes it

Body parameter

Request to create a new payout transaction. This feature is not available by default. Please contact your Naspay relationship manager for details.

Name : body
Flags : required
Type : PayoutRequest

Responses

HTTP Code Description Schema
201 Payout created PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
422 Operation is declined ErrorResponse

Consumes

  • application/json

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/payouts/{id}/actions/approve

Description

Approve a payout with status ON_HOLD

Responses

HTTP Code Description Schema
200 Approve Payout was executed PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/payouts/{id}/actions/cancel

Description

Cancel a payout with status CREATED

Responses

HTTP Code Description Schema
200 Payout was cancelled PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/payouts/{id}/actions/decline

Description

Decline a payout with status ON_HOLD

Responses

HTTP Code Description Schema
200 Decline Payout was executed PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/payouts/{id}/actions/execute

Description

Execute a payout with status CREATED

Responses

HTTP Code Description Schema
200 Payout was executed PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

GET /api/v1/resultCodes

Description

Fetch complete list of result codes

Responses

HTTP Code Description Schema
200 OK Response 200

Response 200

Name Schema
resultCodes
optional
< ResultCodeInfo > array

Produces

  • application/json

Tags

  • info

POST /api/v1/transactions

Description

Creates new payment transaction

Body parameter

Request to create a new payment transaction

Name : body
Flags : required
Type : PaymentRequest

Responses

HTTP Code Description Schema
201 Payment created. PaymentResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
422 Operation is declined ErrorResponse

Consumes

  • application/json

Produces

  • application/json

Tags

  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

GET /api/v1/transactions

Description

Fetch list of transactions

Responses

HTTP Code Description Schema
200 Data fetched Response 200
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Response 200

Name Schema
meta
optional
meta
transactions
optional
< TransactionListInfo > array

meta

Name Schema
hasNext
optional
boolean
hasPrev
optional
boolean
limit
optional
integer
offset
optional
integer

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

GET /api/v1/transactions/{id}

Description

Fetch data of transaction

Parameters

Type Name Description Schema
Path id
required
Transaction Id string

Responses

HTTP Code Description Schema
200 Transaction fetched TransactionDetails
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Transaction not found ErrorResponse

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Transaction Not Found"
}

POST /api/v1/transactions/{id}/actions/capture

Description

Capture authorized payment.

Please ensure to send HTTP header Content-Length: 0 and not send HTTP header Content-Type.

Parameters

Type Name Description Schema Default
Header Content-Length
optional
integer "0"
Path id
required
Id of authorized payment transaction to be captured string

Responses

HTTP Code Description Schema
200 Transaction captured TransactionStateResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Transaction not found ErrorResponse
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Transaction Not Found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/transactions/{id}/actions/payout

Description

Create Payout using card from payment transaction

Parameters

Type Name Description Schema
Path id
required
Id of payment transaction to get card details from string

Body parameter

Request to create payout for Purchase transaction

Name : body
Flags : required
Type : PayoutForPurchaseRequest

Responses

HTTP Code Description Schema
201 Payout created PayoutResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Transaction not found ErrorResponse
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Consumes

  • application/json

Produces

  • application/json

Tags

  • payouts

Security

Type Name Scopes
oauth2 oauth2Security payouts

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Transaction Not Found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/transactions/{id}/actions/refund

Description

Refund captured payment

Parameters

Type Name Description Schema
Path id
required
Id of captured payment transaction to be refunded string

Body parameter

Request for refund payment transaction

Name : body
Flags : required
Type : RefundRequest

Responses

HTTP Code Description Schema
201 Refund created RefundResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Transaction not found ErrorResponse
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Consumes

  • application/json

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Transaction Not Found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

POST /api/v1/transactions/{id}/actions/void

Description

Void authorized payment

Please ensure to send HTTP header Content-Length: 0 and not send HTTP header Content-Type.

Parameters

Type Name Description Schema Default
Header Content-Length
optional
integer "0"
Path id
required
Id of authorized payment transaction to be voided string

Responses

HTTP Code Description Schema
200 Transaction voided TransactionStateResponse
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError
404 Transaction not found ErrorResponse
409 Unexpected state of payment transaction: “Illegal Workflow State” or “Transaction is Locked” ErrorResponse
422 Operation is declined ErrorResponse

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}
Response 404

{
  "status" : "error",
  "code" : 404,
  "message" : "Transaction Not Found"
}
Response 409

{
  "error" : {
    "status" : 409,
    "code" : "09.20.008",
    "message" : "Transaction is Locked"
  }
}
Response 422

{
  "error" : {
    "status" : 400,
    "code" : "01.20.000",
    "message" : "Bad Request"
  }
}

GET /api/v1/transactions/{id}/history

Description

Fetch transaction operations history

Parameters

Type Name Description Schema
Path id
required
Id of transaction string

Responses

HTTP Code Description Schema
200 Data fetched < TransactionHistoryItem > array
400 Invalid input ErrorResponse
401 Bearer token is missing or invalid
Headers :
WWW_Authenticate (string)
UnauthorizedError

Produces

  • application/json

Tags

  • backoffice
  • payments

Security

Type Name Scopes
oauth2 oauth2Security transactions

Example HTTP response

Response 401

{
  "error" : "invalid_token",
  "error_description" : "Access token is not found"
}

Get Access Token

GET /auth/token

Description

Retrieve an access token for use with your API calls

Parameters

Type Name Description Schema Default
Query grant_type
required
Value must be set to client_credentials enum (client_credentials) "client_credentials"

Responses

HTTP Code Description Schema
200 The access token request is valid and authorized AccessTokenResponse
401 The request failed client authentication or is invalid Error

Produces

  • application/json

Tags

  • auth

Security

Type Name
basic basicSecurity

Definitions

AbstractResource

This is abstract type – definition of common properties used by resource responses

Name Description Schema
error
optional
When present, indicates that request has completed with error. Error
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object

AbstractTransaction

This is abstract type – definition of common properties used by PurchaseTransaction, RefundTransaction and PayoutTransaction

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cardBrand
optional
CardBrand
cardExpiryMonth
optional
Expiry month as stated on the Card. (1-12)
Minimum value : 1
Maximum value : 12
Example : 5
integer
cardExpiryYear
optional
Expiry year as stated on the Card. 4 digits
Minimum value : 2018
Maximum value : 2050
Example : 2022
integer
cardToken
optional
Reference to the stored card data
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
cardholder
optional
Cardholder name
Maximal length : 13
string
commission
optional
Transaction commission
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
cryptoAmount
optional
Transaction crypto amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cryptoCurrency
optional
Currency
currency
required
Currency
customerAccessToken
optional
Unique transaction Id for Customers and External Systems
Maximal length : 36
Example : "3c1daf0f-5ff0-4a1d-8284-038073640683"
string
customerAccountId
optional
Customer Account Id in external system (e.g. PayPal PayerID)
Maximal length : 64
string
customerBankId
optional
The bank id used by the terminal to handle the transaction
Maximal length : 64
string
customerEmail
optional
Customer Email
Maximal length : 512
string
description
optional
Description of the transaction shown to Customer
Maximal length : 512
string
executionId
optional
Transaction Id in external system (Processor Transaction ID)
Maximal length : 64
string
id
required
Unique internal transaction Id TransactionId
isMOTO
optional
Flag that indicates if the order was manually created in Merchant Portal boolean
maskedPan
optional
Masked PAN
Maximal length : 13
string
merchantCustomerId
optional
Id of the customer assigned by Merchant.
Maximal length : 128
string
mt4Id
optional
The MT4 account identifier/login i.e. 123456 or other string
Maximal length : 64
string
paymentMethod
optional
Payment method - defaults to CASHIER for payments and to CREDIT_CARD for payouts PaymentMethod
processor
optional
Processor name of description
Maximal length : 128
string
providerAmount
optional
Transaction provider amount - available when currency exchange is used
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
providerCurrency
optional
Currency
recurringToken
optional
Multi-use reference token to be used for recurring operations
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
state
required
TransactionState
type
required
TransactionType
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)
verificationData
optional
The customer verification data map (key - value pairs): i.e. {‘firstName’:‘NO_MATCH’, ‘lastName’:‘MATCH’} object
verificationLevel
optional
The customer verification level i.e. 00, 01, 10, 11 or other string
Maximal length : 16
string

AccessTokenResponse

Name Description Schema
access_token
optional
The access token issued by PSP. The access token will expire (see expires_in), after which you’ll have to request a new access token.
Example : "f3ca90fc-f492-4ff3-872a-5f0b84a09445"
string
expires_in
optional
The lifetime in seconds of the access token
Example : 600
integer
scope
optional
Scopes expressed in the form of resource URL endpoints. The value of the scope parameter is expressed as a list of space-delimited, case-sensitive strings. string
token_type
optional
The type of the token issued as described in OAuth2.0 RFC6749, Section 7.1. Value is case insensitive. Always returns: “bearer
Example : "bearer"
enum (bearer)

ApiAccessMode

Type : enum (PAYMENT_PAGE, SERVER_TO_SERVER)

BillingAddress

The billing address is the address associated with payment card

Name Description Schema
city
required
City name
Maximal length : 80
string
countryCode
required
2-character IS0-3166-1 country code
Length : 2
Pattern : "[A-Z]{2}"
string
line1
required
Line 1 of the address (e.g., Number, street, etc)
Maximal length : 100
string
line2
optional
Line 2 of the address (e.g., Suite, apt #, etc)
Maximal length : 100
string
phone
optional
Phone number representing the customer. Required for some risk checks.
Maximal length : 25
string
postalCode
optional
Zip code or equivalent. Required in certain countries.
Maximal length : 30
string
state
optional
2-letter code for US states, and the equivalent for other countries
Maximal length : 50
string

Card

Payment card. Must be sent in server-to-server requests when merchant has PCI DSS level 1 compliance. Must be omitted in payment page requests.

Name Description Schema
billingAddress
optional
BillingAddress
cardholder
required
Name of the cardholder as stated on Card
Maximal length : 128
Example : "Mr.Cardholder"
string
cvv
required
Credit card CVV from back side of the card. 3 digits
Length : 3
Example : "012"
string
expiryMonth
required
Expiry month as stated on the Card. (1-12)
Minimum value : 1
Maximum value : 12
Example : 5
integer
expiryYear
required
Expiry year as stated on the Card. 4 digits
Minimum value : 2017
Maximum value : 2050
Example : 2019
integer
pan
required
Primary Account Number
Pattern : "\\d+"
Example : "4000000000000002"
string

CardBrand

Card Brand

Type : enum (VISA, MASTERCARD, MAESTRO, MIR, UNKNOWN)

CardVerifyRequest

A request to verify card

Name Description Schema
amount
required
Transaction amount
Minimum value : 0.01
Maximum value : 999999.99
Example : 0.01
number
card
optional
Information about Credit Card. Required in Server-to-Server mode. Card
currency
required
Currency
customer
required
Information about the Customer Customer
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "ORDER-123456"
string
paymentMethod
optional
Payment method. If not provided then CASHIER will be used. PaymentMethod
startRecurring
optional
Flag to trigger the start of a recurring transaction. A recurring token will be generated and sent back to merchant
Default : false
Example : true
boolean
terminalLinkId
optional
Specific Terminal link Id
Example : "12345"
string

CardVerifyResponse

Polymorphism : Composition

Name Description Schema
amount
optional
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 13.1
number
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
currency
optional
Currency
error
optional
When present, indicates that request has completed with error. Error
id
required
Card Verify Transaction Id TransactionId
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object
state
required
TransactionState
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)

ChargebackState

Chargeback state of the PURCHASE transaction

Type : enum (CLAIM, CHARGEBACK_WON, CHARGEBACK_LOST, CHARGEBACK_REFUNDED)

Currency

ISO 4217 currency code, crypto currency code (XBT is used for BTC, XTH is used for ETH to avoid conflict with fiat currency)

Type : enum (CNY, EUR, GBP, RUB, USD, XBT, B2BX, BCH, DOGE, XTH, USDT, ADA, LTC, XLM, XRP, EOS, BAT, XMR)

Customer

Name Description Schema
accountId
optional
The customer account Id in the external system. Required for some operations.
Maximal length : 64
Example : "1786162"
string
accountType
optional
The customer account type in the external system. Required for some operations.
Maximal length : 64
Example : "C"
string
address1
optional
Maximal length : 100Example : "Red Street No 7" string
address2
optional
Maximal length : 100Example : "Tim Building, Apartment 1" string
bankAccountName
optional
The bank account name in the external system. Required for some operations.
Maximal length : 64
string
bankBranch
optional
The bank Branch in the external system. Required for some operations.
Maximal length : 64
Example : "CDERY123DHH"
string
bankBranchAddress
optional
The bank Branch address in the external system. Required for some operations.
Maximal length : 64
Example : "Finance Street No 7"
string
bankBranchName
optional
The bank Branch name in the external system. Required for some operations.
Maximal length : 64
Example : "BOC - LOFITIS"
string
bankCity
optional
The bank city in the external system. Required for some operations.
Maximal length : 64
Example : "Limassol"
string
bankId
optional
The bank Id in the external system. Required for some operations.
Maximal length : 64
Example : "CDERYDHH"
string
bankName
optional
The bank name in the external system. Required for some operations.
Maximal length : 64
Example : "Bank Of Cyprus"
string
bankProvince
optional
The bank province in the external system. Required for some operations.
Maximal length : 64
Example : "Limassol"
string
bankTransactionId
optional
The bank transaction Id in the external system. Required for some operations.
Maximal length : 64
Example : "CDERY123DHH"
string
channel
optional
A payment option in the external system. Required for some operations.
Maximal length : 64
Example : "CASH"
string
city
optional
Maximal length : 80Example : "Los Angeles" string
countryCode
optional
Length : 2Example : "US" string
currency
optional
Customer currency in the merchant system
Maximal length : 3
Example : "EUR"
string
dateOfBirth
optional
Example : "YYYY-MM-DD format: i.e. 1970-12-30" string(date)
documentType
optional
The identification document type. Required for some operations.
Maximal length : 64
Example : "PASS"
string
email
required
Email address representing the customer
Maximal length : 127
Example : "andy@example.com"
string
firstName
optional
Maximal length : 50Example : "John" string
gender
optional
Biological gender at birth: male or female
Maximal length : 16
Example : "male"
string
ip
optional
Maximal length : 39Example : "216.3.128.12" string
lastName
optional
Maximal length : 50Example : "Snow" string
locale
optional
Preferred locale for the payment page in ISO 639-1 format. If not provided the en locale will be used. Locale
merchantCustomerId
optional
Id of the customer assigned by Merchant.
Maximal length : 128
Example : "cus-123456"
string
personalId
optional
The national/unique identification number. Required for some operations.
Maximal length : 64
string
phone
optional
Phone number representing the customer. Required for some risk checks.
Maximal length : 50
Example : "+22 607 123 4567"
string
phoneCountryCode
optional
Maximal length : 4Example : "0044 for UK" string
postCode
optional
Maximal length : 30Example : "90210" string
registrationCountryCode
optional
Country code used by the customer to register in the merchant system
Maximal length : 2
Example : "AU"
string
registrationDate
optional
The date when the customer was registered in the the external system (i.e. merchant system). Required for some operations.
Example : "YYYY-MM-DD format: i.e. 1970-12-30"
string(date)
registrationIp
optional
IP from where the customer registered in the merchant system
Maximal length : 39
Example : "216.3.128.12"
string
securityCode
optional
Any security related code/password/otp. Required for some operations.
Maximal length : 64
string
state
optional
Maximal length : 50Example : "California" string
taxNumber
optional
Tax fiscal number of customer
Maximal length : 64
Example : "357123"
string
userAgent
optional
Maximal length : 512Example : "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/56.0.2924.75 Mobile/14E5239e Safari/602.1" string

CustomerError

If present in the response, indicates that requested operation has not been completed successfully.

Name Description Schema
error
optional
Error message
Example : "Bad Request"
string
exception
optional
Java related exception message
Example : "org.springframework.http.converter.HttpMessageNotReadableException"
string
message
optional
Error message
Example : "Bad Request"
string
path
optional
Path used in the request
Example : "/api/v1/customers"
string
status
optional
HTTP Status Code
Example : 400
integer
timestamp
optional
Date and time when the operation reply was sent
Example : "2018-01-30T17:15:13.130+0000"
string

CustomerResponse

Polymorphism : Composition

Name Description Schema
customer
optional
Customer
error
optional
When present, indicates that request has completed with error. Error
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object

Error

If present in the response, indicates that requested operation has not been completed successfully.

Name Description Schema
code
required
The unique code that indicates the result status of the request. See the Result Codes for more detailed information.
Example : "06.40.000"
string
description
optional
Detailed description of the error string
fieldErrors
optional
Information about erroneous request fields, if any < FieldError > array
message
required
Error message
Example : "Transaction declined by bank"
string
status
required
HTTP Status Code integer

ErrorResponse

Polymorphism : Composition

Name Description Schema
error
optional
When present, indicates that request has completed with error. Error
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object

ExternalResultInfo

Name Description Schema
resultCode
optional
External system result code
Maximal length : 256
string
resultMessage
optional
External system result message
Maximal length : 512
string

FieldError

Name Description Schema
field
required
Erroneous field path string
message
required
Field error message string

KYCAddress

KYC - defines properties of the customer’s address

Name Description Schema
addressLine1
optional
Field to contain address related data: street, number, flat etc
Example : "Wisdom street, No 7, Flat 3"
string
addressLine2
optional
Field to contain address related data: area, street, number, flat etc
Example : "Highland area"
string
city
optional
The city of the person’s address
Example : "Melbourne"
string
countryCode
required
The country of the person’s address
Example : "AU"
string
matchDetails
optional
MatchDetails
postalCode
optional
The postalCode of the person’s address
Example : "3000"
string
state
optional
The state of the person’s address
Example : "Victoria"
string

KYCCustomer

Name Description Schema
address
required
KYCAddress
comment
optional
Free text or description related to customer
Example : "this record is updated every 3 months"
string
dataSource
optional
KYCDataSource
dateOfBirth
optional
Example : "YYYY-MM-DD format: i.e. 1970-12-30" string(date)
datesOfBirth
optional
A list of known customer dates of birth < KycDateOfBirth > array
email
optional
Email address representing the customer
Maximal length : 127
Example : "andy@example.com"
string
extSystemId1
optional
The customer Id in the external system
Maximal length : 64
Example : "CDER123YDHH"
string
extSystemId2
optional
The customer Id in the external system
Maximal length : 64
Example : "333777999"
string
firstName
optional
Maximal length : 50Example : "John" string
gender
optional
Email address representing the customer
Maximal length : 16
Example : "andy@example.com"
string
genericData
optional
A list of customer related information: i.e. PEP (politically exposed person) records, Sanctions records < KYCGenericData > array
ip
optional
IP address of the customer
Maximal length : 127
Example : "101.101.101.101"
string
lastName
optional
Maximal length : 50Example : "Snow" string
matchDetails
optional
MatchDetails
merchantCustomerId
required
Id of the customer assigned by Merchant.
Maximal length : 128
Example : "cus-123456"
string
nationalities
optional
A list of customer nationalities < string > array
otherNames
optional
A list of alternative names of the person < KycOtherName > array
personalNumber
optional
The customer national id
Maximal length : 64
Example : "1786162112"
string
phone
optional
Phone number that belongs to the customer
Maximal length : 50
Example : "+22 607 123 4567"
string
phones
optional
KYCPhones
placesOfBirth
optional
A list of customer places of birth < KYCAddress > array
relatives
optional
The customer relatives object
roles
optional
A list of the roles the customer had in the past < KYCRole > array

KYCDataSource

KYC Provider details

Name Description Schema
category
optional
Customer details source data type
Example : "SANCTION, PEP"
string
name
optional
Name of the KYC provider data source
Example : "EU_GLOBAL"
string
rawData
optional
KYC provider raw data - to be used in case of unexpected data format
Example : "Name:JOHN;Surname:DOE;Title:<raw1>director</row1>"
string
requestId
optional
The request Id provided by the KYC provider
Example : "7233d3db-9fc7-4010-b0ea-87dc7d987c1d"
string

KYCGenericData

Generic data related to the customer

Name Description Schema
note
optional
< string > array
type
optional
Field to contain data type
Example : "PEP, SANCTIONS"
string

KYCLoginRequest

KYC - defines properties of the Login request transaction.

Name Description Schema
customer
required
KYCCustomer
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 64
Example : "ORDER-123456"
string
providerCode
optional
KycProviderCode
returnUrl
required
The Merchant URL shown to the customer after a completed or declined identification
Example : "http://example.com/12345abcde/status"
string
webhookUrl
required
The Merchant webhook URL which will be called when the identification process is completed. Naspay will sent a KYCResponse object as payload
Example : "http://example.com/12345abcde/webhook"
string

KYCPhones

A list of phone numbers with the type.

Name Description Schema
phone
optional
The phone number
Example : "+300551133777"
string
type
optional
The phone type
Example : "MOBILE"
string

KYCRedirectResponse

KYC - defines properties of the Login/Registration transaction response.

Name Description Schema
id
optional
Id of the transaction assigned by Naspay
Example : "ORDER123"
string
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Example : "ORDER-123456-M"
string
redirectUrl
optional
The Naspay redirect URL. The customer needs to be redirected to this URL to continue the identification process
Example : "http://example.com/ORDER123/redirect"
string

KYCRegisterChecksRequest

KYC Register Checks - defines properties of the request transaction.

Name Description Schema
customer
required
KYCCustomer
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 64
Example : "ORDER-123456"
string
providerCode
optional
KycProviderCode

KYCRegisterRequest

KYC - defines properties of the Registration request transaction.

Name Description Schema
customer
required
KYCCustomer
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 64
Example : "ORDER-123456"
string
providerCode
optional
KycProviderCode
returnUrl
required
The Merchant status URL shown to the customer after a completed or declined identification
Example : "http://example.com/12345abcde/status"
string
webhookUrl
required
The Merchant webhook URL which will be called when the identification process is completed. Naspay will sent a KYCResponse object as payload. The payload will contain the registered customer details
Example : "http://example.com/12345abcde/webhook"
string

KYCRelatives

Customer relatives

Name Description Schema
children
optional
A list of customer children details < KYCCustomer > array
noOfChildren
optional
The number of children the customer has
Example : 1
integer
noOfSiblings
optional
The number of siblings the customer has
Example : 3
integer
parent1
optional
A list of customer parent1 details(i.e. mother) < KYCCustomer > array
parent2
optional
A list of customer parent2 details(i.e. father) < KYCCustomer > array
siblings
optional
A list of customer siblings details < KYCCustomer > array
spouses
optional
A list of customer spouses details < KYCCustomer > array

KYCResponse

KYC - defines properties of the transaction response. Fields always present: id, merchantTransactionId, transactionState, resultCode, customer.merchantCustomerId

Name Description Schema
customer
optional
KYCCustomer
customers
optional
A list of Customers < KYCCustomer > array
error
optional
Error message related to validations or other systems related errors
Example : "Country AU is not a supported"
string
id
optional
Id of the transaction assigned by Naspay
Example : "6d353a24d1d24b49bf69fc0cb4d25b8a"
string
identToken
optional
Token of the KYC operation created by an LOGIN/REGISTRATION request.
Example : "6556-ffrxzxxryzn0ovki08ca"
string
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Example : "ORDER-123456-M"
string
resultCode
optional
ResultCode
transactionState
optional
KycTxState

KYCRole

Role details of a past customer position

Name Description Schema
category
optional
Field to contain role category
Example : "administration"
string
since
optional
Field to contain role start date
Example : "2010-09-29"
string
title
optional
Field to contain role title
Example : "manager"
string
to
optional
Field to contain role end date
Example : "2012-09-29"
string
type
optional
Field to contain role type
Example : "part time position"
string

KycDateOfBirth

Customer Date of Birth in format yyyy-MM-dd

Name Description Schema
note
optional
Field to contain a date related description
Example : "Public records information"
string

KycOtherName

Alternative customer name

Name Description Schema
name
optional
Field to contain alternative customer name
Example : "John, Henry The Second, Dodo"
string
type
optional
Field to contain alternative customer name type
Example : "First Name, Alias, Nickname"
string

KycProviderCode

KYC provider code

Type : enum (ENTERCASH, ZIGNSEC, NASPAY)

KycTxState

The transaction status

Type : enum (COMPLETED, DECLINED)

The object represents HATEOAS link. href attribute defined an actual URL. Link type (the rel attribute) can be one of the following types:

  • self – URL of the transaction for access via API only
  • payment – link can be used by the Customer as stable transaction URL
  • checkout – If present then the Merchant should redirect the Customer to this URL to proceed with payment/payout
  • payment_ref – link is valid for RefundResponse and can be used to access original payment transaction via API
Name Schema
href
required
string
rel
required
enum (self, checkout, payment, void, capture, payment_ref, cancel, execute, approve, decline, refund, first, last, next, previous)

Locale

Locale in ISO 639-1 format

Type : string

MatchDetails

KYC - defines the match details

Name Description Schema
data
optional
A map of key-value pairs related to the KYC operation
Example : "{'Telecom1-LASTNAME':'Full match was made on Last Name/Surname', 'Postal-POSTALCODE':'Full match was made on Postal Code/Zip Code'}"
string
isMatch
optional
The field will show if KYC item was found
Example : true
boolean
level
optional
MatchLevel

MatchLevel

The match accuracy

Type : enum (LOW, MEDIUM, HIGH)

MerchantTerminalList

Name Schema
merchantTerminals
optional
< MerchantTerminalListItem > array

MerchantTerminalListItem

Name Description Schema
apiAccessMode
optional
ApiAccessMode
currencies
optional
< Currency > array
id
optional
integer
name
optional
string
paymentMethods
optional
An array of payment methods available to the merchant terminal < PaymentMethod > array
shopUrl
optional
Maximal length : 512 string

OperationState

OperationType is used in transaction history response

Type : enum (IN_PROGRESS, COMPLETED, DECLINED, CANCELLED, TIMEOUT, ERROR)

OperationType

OperationType is used in transaction history response

Type : enum (CREATE_PAYMENT, FILL_FORM, FILL_PREPARE_FORM, CONFIRM_CURRENCY_EXCHANGE, ANTIFRAUD, VERIFY_ENROLLMENT, CHECK_3DS, AUTHORIZE, CAPTURE, VOID, REFUND, CANCEL, DECLINE, CREATE_REFUND, EXECUTE_REFUND, PAYOUT, CREATE_PAYOUT, EXECUTE_PAYOUT, APPROVE_PAYOUT, DECLINE_PAYOUT, SET_CHARGEBACK_STATE, SET_STATUS, VERIFY_CARD)

PaymentIntent

Payment intent. Can be set to SALE for immediate funds withdrawal or AUTHORIZE to authorize a payment and withdraw funds from a Customer account later by executing capture operation.

Type : enum (AUTHORIZE, SALE)

PaymentMethod

Payment method. Select between various methods of payment – CREDIT_CARD is chosen by default.

Type : enum (CREDIT_CARD, SKRILL, PAYPAL, NETELLER, RPNPAY, PRZELEWY24, SOFORT, UPAYCARD, UPAYCARD_WIRE, JETON_WALLET, PAYSAFECARD, INTERAC, INTERAC_ETRANSFER, APCOPAY, CLEARSETTLE, ENTERCASH, TRUSTLY, TRUSTLY_PNP, INTERKASSA, KLUWP, ECOPAYZ, ASTROPAY, CASHIER, ECOMMPAY_TERMINAL, B2CRYPTO, CITADEL, EFTPAY, CRYPTOCURRENCY_EXTERNAL, BANKTRANSFER, VOGUEPAY, FLEXEPIN, BESTPAYCARD, COMMUNITY_BANK, CEP_BANK, SEPA, PAYTRIO, PAYRETAILERS, PAY2BEE, WECHAT, QQPAY, PAYSEC, QR, PAYMENTCENTER, REGULARPAY, VLOAD, BLACK42PAY, ECOMMPAY, ESTROPAY, GLOBEPAY, SAFECHARGE, B2BINPAY, STICPAY, MUCHBETTER, ENVOYPAY, PAYGIGA, SOLIDPAYMENTS, FASAPAY, MINERBOOKING, DIJIPAYS, TERREXA, ZIGNSEC_SWISH, THE_CHANGE, ZIMPLER, INTRORIX, ZOTAPAY, EASYEFT, NORDEA, IKAJO, NETPAY, TRONIPAY, TRONIPAY_CRYPTO, IACCOUNT, PAYBOUTIQUE, YANDEX_MONEY, QIWI, EPG, DRAGONPHOENIX, AWEPAY, PAYTECHNO_CRYPTO, MPESA, PAYTRUST88, XENTUM, ASTROPAY_CARD, OROUNDA, LEOGAMING)

PaymentRequest

A request to create new payment transaction. Should contain at least amount, currency, merchantTransactionId and description fields

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number
card
optional
Information about Credit Card. Required in Server-to-Server mode. Card
cardToken
optional
Reference to the stored card data
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
currency
required
Currency
customer
optional
Information about the Customer. Required in Server-to-Server mode. Customer
description
required
Description of the transaction
Maximal length : 512
Example : "Purchase: 9 red roses"
string
intent
optional
Payment intent. If not provided then SALE will be used. PaymentIntent
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "ORDER-123456"
string
paymentMethod
optional
Payment method. If not provided then CASHIER will be used. PaymentMethod
recurringToken
optional
Multi-use reference token to be used for recurring operations
Maximal length : 32
Example : "2bfe72bccdf44e16a044b8266389b05f"
string
shippingAddress
optional
ShippingAddress
startRecurring
optional
Flag to trigger the start of a recurring transaction. A recurring token will be generated and sent back to merchant
Example : true
boolean

PaymentResponse

Polymorphism : Composition

Name Description Schema
amount
optional
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 13.1
number
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
currency
optional
Currency
description
optional
Maximal length : 512 string
error
optional
When present, indicates that request has completed with error. Error
id
required
Transaction Id TransactionId
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "ORDER-123456"
string
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object
shippingAddress
optional
ShippingAddress
state
required
TransactionState
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)

PayoutForPurchaseRequest

A request to create new payout using data from Purchase transaction.

Name Description Schema
amount
required
Amount of payout
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number
customer
optional
Information about the Customer. Specify only those fields that need to be updated, all other data will be taken from Purchase transaction. Customer
description
required
Description of the payout
Maximal length : 512
string
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "PAYOUT-123456"
string

PayoutIntent

Payout intent. Use CREATE to store Payout request for later execution or EXECUTE to execute it immediately. If not provided then EXECUTE is chosen by default.

Type : enum (CREATE, EXECUTE)

PayoutRequest

A request to create new payout.

Name Description Schema
amount
required
Amount of payout
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number
card
optional
Information about Credit Card. Required in Server-to-Server mode. Card
currency
required
Currency
customer
optional
Information about the Customer. Required in Server-to-Server mode. Customer
description
required
Description of the payout
Maximal length : 512
string
intent
optional
Payout Intent. If not provided then EXECUTE will be used. PayoutIntent
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "PAYOUT-123456"
string
paymentMethod
optional
Payment method. If not provided then CREDIT_CARD will be used. PaymentMethod

PayoutResponse

Polymorphism : Composition

Name Description Schema
amount
optional
Amount of payout
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 13.1
number
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
currency
optional
Currency of payout Currency
description
optional
Optional description of the payout
Maximal length : 512
Example : "Withdrawal to customer ID123456"
string
error
optional
When present, indicates that request has completed with error. Error
id
required
Transaction Id TransactionId
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "ORDER-123456"
string
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object
state
required
The state of payout transaction TransactionState
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)

PayoutTransaction

Defines properties of the PAYOUT transaction.

Polymorphism : Inheritance
Discriminator : type

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cardBrand
optional
CardBrand
cardExpiryMonth
optional
Expiry month as stated on the Card. (1-12)
Minimum value : 1
Maximum value : 12
Example : 5
integer
cardExpiryYear
optional
Expiry year as stated on the Card. 4 digits
Minimum value : 2018
Maximum value : 2050
Example : 2022
integer
cardToken
optional
Reference to the stored card data
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
cardholder
optional
Cardholder name
Maximal length : 13
string
commission
optional
Transaction commission
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
cryptoAmount
optional
Transaction crypto amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cryptoCurrency
optional
Currency
currency
required
Currency
customerAccessToken
optional
Unique transaction Id for Customers and External Systems
Maximal length : 36
Example : "3c1daf0f-5ff0-4a1d-8284-038073640683"
string
customerAccountId
optional
Customer Account Id in external system (e.g. PayPal PayerID)
Maximal length : 64
string
customerBankId
optional
The bank id used by the terminal to handle the transaction
Maximal length : 64
string
customerEmail
optional
Customer Email
Maximal length : 512
string
description
optional
Description of the transaction shown to Customer
Maximal length : 512
string
executionId
optional
Transaction Id in external system (Processor Transaction ID)
Maximal length : 64
string
id
required
Unique internal transaction Id TransactionId
isMOTO
optional
Flag that indicates if the order was manually created in Merchant Portal boolean
maskedPan
optional
Masked PAN
Maximal length : 13
string
merchantCustomerId
optional
Id of the customer assigned by Merchant.
Maximal length : 128
string
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "PAYOUT-123456"
string
mt4Id
optional
The MT4 account identifier/login i.e. 123456 or other string
Maximal length : 64
string
paymentMethod
optional
Payment method - defaults to CASHIER for payments and to CREDIT_CARD for payouts PaymentMethod
processor
optional
Processor name of description
Maximal length : 128
string
providerAmount
optional
Transaction provider amount - available when currency exchange is used
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
providerCurrency
optional
Currency
recurringToken
optional
Multi-use reference token to be used for recurring operations
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
state
required
TransactionState
type
required
TransactionType
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)
verificationData
optional
The customer verification data map (key - value pairs): i.e. {‘firstName’:‘NO_MATCH’, ‘lastName’:‘MATCH’} object
verificationLevel
optional
The customer verification level i.e. 00, 01, 10, 11 or other string
Maximal length : 16
string

PurchaseTransaction

Defines properties of the PURCHASE transaction.

Polymorphism : Inheritance
Discriminator : type

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cardBrand
optional
CardBrand
cardExpiryMonth
optional
Expiry month as stated on the Card. (1-12)
Minimum value : 1
Maximum value : 12
Example : 5
integer
cardExpiryYear
optional
Expiry year as stated on the Card. 4 digits
Minimum value : 2018
Maximum value : 2050
Example : 2022
integer
cardToken
optional
Reference to the stored card data
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
cardholder
optional
Cardholder name
Maximal length : 13
string
chargebackState
optional
ChargebackState
commission
optional
Transaction commission
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
cryptoAmount
optional
Transaction crypto amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cryptoCurrency
optional
Currency
currency
required
Currency
customerAccessToken
optional
Unique transaction Id for Customers and External Systems
Maximal length : 36
Example : "3c1daf0f-5ff0-4a1d-8284-038073640683"
string
customerAccountId
optional
Customer Account Id in external system (e.g. PayPal PayerID)
Maximal length : 64
string
customerBankId
optional
The bank id used by the terminal to handle the transaction
Maximal length : 64
string
customerEmail
optional
Customer Email
Maximal length : 512
string
description
optional
Description of the transaction shown to Customer
Maximal length : 512
string
executionId
optional
Transaction Id in external system (Processor Transaction ID)
Maximal length : 64
string
id
required
Unique internal transaction Id TransactionId
isMOTO
optional
Flag that indicates if the order was manually created in Merchant Portal boolean
maskedPan
optional
Masked PAN
Maximal length : 13
string
merchantCustomerId
optional
Id of the customer assigned by Merchant.
Maximal length : 128
string
merchantTransactionId
required
Id of the transaction assigned by Merchant
Maximal length : 100
Example : "ORDER-123456"
string
mt4Id
optional
The MT4 account identifier/login i.e. 123456 or other string
Maximal length : 64
string
paymentMethod
optional
Payment method - defaults to CASHIER for payments and to CREDIT_CARD for payouts PaymentMethod
processor
optional
Processor name of description
Maximal length : 128
string
providerAmount
optional
Transaction provider amount - available when currency exchange is used
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
providerCurrency
optional
Currency
recurringToken
optional
Multi-use reference token to be used for recurring operations
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
refundedAmount
optional
Amount refunded. Can’t be greater than transaction amount. Value may not be present, when it is zero.
Minimum value : 1.0E-18
Maximum value : 999999.99
number(decimal)
state
required
TransactionState
type
required
TransactionType
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)
verificationData
optional
The customer verification data map (key - value pairs): i.e. {‘firstName’:‘NO_MATCH’, ‘lastName’:‘MATCH’} object
verificationLevel
optional
The customer verification level i.e. 00, 01, 10, 11 or other string
Maximal length : 16
string

RefundRequest

Name Description Schema
amount
required
Amount to refund in the same currency as original payment.
Can’t be greater than amount of the original payment transaction minus already refunded amount.
Minimum value : 1.0E-18
Maximum value : 999999.99
number
description
optional
Maximal length : 512 string

RefundResponse

Polymorphism : Composition

Name Description Schema
amount
optional
Refund amount in the same currency as original payment.
Can not be greater than initial transaction amount minus already refunded amount.
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 12.98
number
created
optional
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:42Z"
string(date-time)
description
optional
Description (comment) of the refund request
Maximal length : 512
Example : "Refunded due to service was not provided"
string
error
optional
When present, indicates that request has completed with error. Error
id
optional
Transaction Id TransactionId
links
optional
If present, a links member can be used to represent links. The value of each links member is a “Links” object. < Link > array
meta
optional
When present, a meta member can be used to include non-standard meta-information. The value of each meta member is an object (a “meta object”).

Any members MAY be specified within meta objects.
object
paymentTransactionId
optional
Id of payment transaction string
state
optional
TransactionState
updated
optional
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)

RefundTransaction

Defines properties of the REFUND transaction.

The amount of refund transaction is always in the same currency as original payment, and it can not exceed initial transaction amount minus already refunded amount.

Polymorphism : Inheritance
Discriminator : type

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cardBrand
optional
CardBrand
cardExpiryMonth
optional
Expiry month as stated on the Card. (1-12)
Minimum value : 1
Maximum value : 12
Example : 5
integer
cardExpiryYear
optional
Expiry year as stated on the Card. 4 digits
Minimum value : 2018
Maximum value : 2050
Example : 2022
integer
cardToken
optional
Reference to the stored card data
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
cardholder
optional
Cardholder name
Maximal length : 13
string
commission
optional
Transaction commission
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
created
required
Transaction’s creation timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:43Z"
string(date-time)
cryptoAmount
optional
Transaction crypto amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
cryptoCurrency
optional
Currency
currency
required
Currency
customerAccessToken
optional
Unique transaction Id for Customers and External Systems
Maximal length : 36
Example : "3c1daf0f-5ff0-4a1d-8284-038073640683"
string
customerAccountId
optional
Customer Account Id in external system (e.g. PayPal PayerID)
Maximal length : 64
string
customerBankId
optional
The bank id used by the terminal to handle the transaction
Maximal length : 64
string
customerEmail
optional
Customer Email
Maximal length : 512
string
description
optional
Description of the transaction shown to Customer
Maximal length : 512
string
executionId
optional
Transaction Id in external system (Processor Transaction ID)
Maximal length : 64
string
id
required
Unique internal transaction Id TransactionId
isMOTO
optional
Flag that indicates if the order was manually created in Merchant Portal boolean
maskedPan
optional
Masked PAN
Maximal length : 13
string
merchantCustomerId
optional
Id of the customer assigned by Merchant.
Maximal length : 128
string
mt4Id
optional
The MT4 account identifier/login i.e. 123456 or other string
Maximal length : 64
string
paymentMethod
optional
Payment method - defaults to CASHIER for payments and to CREDIT_CARD for payouts PaymentMethod
paymentTransactionId
required
ID of the Purchase transaction TransactionId
processor
optional
Processor name of description
Maximal length : 128
string
providerAmount
optional
Transaction provider amount - available when currency exchange is used
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 19.98
number(decimal)
providerCurrency
optional
Currency
recurringToken
optional
Multi-use reference token to be used for recurring operations
Maximal length : 32
Example : "d7993562260c4ec2904612e5aa787261"
string
state
required
TransactionState
type
required
TransactionType
updated
required
Transaction’s last update timestamp as defined by full-date in RFC3339
Example : "2017-01-10T09:37:51Z"
string(date-time)
verificationData
optional
The customer verification data map (key - value pairs): i.e. {‘firstName’:‘NO_MATCH’, ‘lastName’:‘MATCH’} object
verificationLevel
optional
The customer verification level i.e. 00, 01, 10, 11 or other string
Maximal length : 16
string

ResultCode

Result code. See https://naspay.com/docs/result-codes

Type : string

ResultCodeInfo

Name Description Schema
code
required
Result code has format dd.dd.ddd, i.e. 3 groups of digits. See Result Codes section for details.
Length : 9
Pattern : "[0-9]{2}\\.[0-9]{2}\\.[0-9]{3}"
Example : "01.23.456"
string
description
required
ResultCode’s description string

ShippingAddress

The shipping address is where customer wants order delivered. This can be the same as the billing address, or it can be different.

Name Description Schema
city
required
City name
Maximal length : 80
string
countryCode
required
2-character IS0-3166-1 country code
Length : 2
Pattern : "[A-Z]{2}"
string
line1
required
Line 1 of the address (e.g., Number, street, etc)
Maximal length : 100
string
line2
optional
Line 2 of the address (e.g., Suite, apt #, etc)
Maximal length : 100
string
phone
optional
Phone number representing the customer. Required for some risk checks.
Maximal length : 50
string
postalCode
optional
Zip code or equivalent. Required in certain countries.
Maximal length : 30
string
recipientName
required
Intended recipients name
Maximal length : 100
string
state
optional
2-letter code for US states, and the equivalent for other countries
Maximal length : 50
string

TransactionChangedEvent

Name Description Schema
created
required
Event’s creation timestamp. As defined by full-date in RFC3339 string(date-time)
error
optional
Error field is present when operation has not completed successfully ResultCodeInfo
externalResultInfo
optional
ExternalResultInfo
operationState
required
OperationState
operationType
required
OperationType
transaction
required
AbstractTransaction
type
required
enum (TransactionChangedEvent)

TransactionDetails

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
number
chargebackState
optional
Chargeback State ChargebackState
created
optional
read-only
Date and time when transaction was created string
currency
required
Currency
customer
optional
Information about Customer Customer
description
required
Maximal length : 512 string
id
optional
Unique transaction Id TransactionId
links
required
< Link > array
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Maximal length : 128
string
paymentMethod
optional
Payment method - defaults to CASHIER for payments and to CREDIT_CARD for payouts PaymentMethod
refundedAmount
optional
Amount refunded. Applicable only for payment transactions. Can’t be greater than transaction amount.
Minimum value : 1.0E-18
Maximum value : 999999.99
number
resultCode
optional
ResultCode
shippingAddress
optional
ShippingAddress
state
optional
Transaction State TransactionState
type
optional
Transaction type TransactionType
updated
optional
read-only
Date and time when transaction was last updated string

TransactionHistoryItem

Name Schema
details
optional
string
operation
optional
OperationType
operationState
optional
OperationState
resultCode
optional
ResultCode
timestamp
optional
string
transactionState
optional
TransactionState

TransactionId

Transaction ID

Type : string

TransactionListInfo

Name Description Schema
amount
required
Transaction amount
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 123.45
number
arn
optional
Acquirer’s Reference Number string
cardBrand
optional
Card brand string
cardNumber
optional
Masked card number
Example : "400000...0002"
string
cardholder
optional
Cardholder name
Example : "Mr. Cardholder"
string
chargebackState
optional
ChargebackState
created
required
Date and time when transaction was created
Example : "2017-01-11T08:49:36.524Z"
string
cryptoCurrency
optional
Currency
currency
optional
Currency
email
optional
Customer’s email
Example : "andy@example.com"
string
id
required
Unique transaction Id TransactionId
ip
optional
Customer’s IP address
Example : "216.3.128.12"
string
merchantTransactionId
optional
Id of the transaction assigned by Merchant
Example : "ORDER-1234"
string
orderDescription
optional
Order description
Example : "Purchase 9 red roses"
string
refundedAmount
optional
Amount refunded. Applicable only for payment transactions. Can’t be greater than transaction amount.
Minimum value : 1.0E-18
Maximum value : 999999.99
Example : 12.34
number
resultCode
optional
ResultCode
state
required
TransactionState
type
required
TransactionType
updated
required
Date and time when transaction was last updated
Example : "2017-01-11T08:49:36.523Z"
string

TransactionState

Transaction State

  • ERROR – Transaction processing was not started due to error
  • CREATED – The transaction was just created
  • PENDING – Payment page was shown to Customer
  • IN_PROGRESS – Card details filled, transaction initiated
  • AUTHORIZED – Transaction was authorized by bank
  • ON_HOLD – Transaction was authorized but processing was stopped due to high risk. The transaction should be captured explicitly.
  • COMPLETED – Transaction processing was completed successfully.
  • REFUNDED – Transaction was fully refunded
  • PARTIALLY_REFUNDED – Transaction was refunded partially
  • DECLINED –Transaction was declined
  • VOIDED – Transaction was voided
  • CANCELLED – Transaction was cancelled by the Customer, e.g. by clicking the “Cancel” button on payment page.
  • TIMEOUT – Customer didn’t competed transaction flow, e.g. didn’t return from 3D-Secure check.

Type : enum (ERROR, CREATED, PENDING, IN_PROGRESS, AUTHORIZED, ON_HOLD, COMPLETED, REFUNDED, PARTIALLY_REFUNDED, DECLINED, VOIDED, CANCELLED, TIMEOUT)

TransactionStateResponse

Name Description Schema
created
required
Transaction’s creation timestamp. As defined by full-date in RFC3339 string(date-time)
error
optional
Error field is present when operation has not completed successfully Error
id
required
Transaction Id TransactionId
links
optional
< Link > array
state
required
TransactionState
updated
required
Transaction’s last update timestamp. As defined by full-date in RFC3339 string(date-time)

TransactionType

Transaction Type

Type : enum (PURCHASE, REFUND, PAYOUT)

UnauthorizedError

Name Description Schema
error
required
Example : "invalid_token" string
error_description
required
Example : "Access token is not found" string