Store Travel Address
POST/frontoffice/api/v1/travel/data
Collecting travel information and saving it in PingExchange, if given signature is valid.
- the supplier needs to initially submit their information in the
PingExchange
. - To transmit and save information in the
PingExchange
, it is essential to invoke this API.
Request
Header Parameters
- The resulting hash value is included as x-signature in the request header.
- Please be aware that currently, we exclusively offer support for
HMAC256
. - Generated hash value should be in
Hex
format.
Before calling this API, the originatorBeneficiary object should be converted into a JSON object (not indented, camelCase) and then encrypted using the HMAC SHA256
encryption algorithm with the shared key.
- application/json-patch+json
- application/json
- text/json
- application/*+json
Body
required
StoreAddress request.
-
The body object of this method comprises two primary sections:
-
originatorBeneficiary
andvaspId
.
originatorBeneficiary
object
required
originator
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID.
Possible values: <= 255 characters
, Value must match regular expression ^([\p{L}\p{N}\s-/])*$
Represents the name of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-,.\s]*$
Represents the physical address of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the document number of the originator.
Represents the date of birth of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the place of birth of the originator.
beneficiary
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the name of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The VASP ID of the originator.
Possible values: <= 12 characters
, Value must match regular expression ^[a-zA-Z]{3,12}$
The asset ID.
Possible values: <= 128 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The transaction ID.
The amount associated with the transaction.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The Virtual Asset Provider ID.
Body
required
StoreAddress request.
-
The body object of this method comprises two primary sections:
-
originatorBeneficiary
andvaspId
.
originatorBeneficiary
object
required
originator
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID.
Possible values: <= 255 characters
, Value must match regular expression ^([\p{L}\p{N}\s-/])*$
Represents the name of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-,.\s]*$
Represents the physical address of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the document number of the originator.
Represents the date of birth of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the place of birth of the originator.
beneficiary
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the name of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The VASP ID of the originator.
Possible values: <= 12 characters
, Value must match regular expression ^[a-zA-Z]{3,12}$
The asset ID.
Possible values: <= 128 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The transaction ID.
The amount associated with the transaction.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The Virtual Asset Provider ID.
Body
required
StoreAddress request.
-
The body object of this method comprises two primary sections:
-
originatorBeneficiary
andvaspId
.
originatorBeneficiary
object
required
originator
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID.
Possible values: <= 255 characters
, Value must match regular expression ^([\p{L}\p{N}\s-/])*$
Represents the name of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-,.\s]*$
Represents the physical address of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the document number of the originator.
Represents the date of birth of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the place of birth of the originator.
beneficiary
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the name of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The VASP ID of the originator.
Possible values: <= 12 characters
, Value must match regular expression ^[a-zA-Z]{3,12}$
The asset ID.
Possible values: <= 128 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The transaction ID.
The amount associated with the transaction.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The Virtual Asset Provider ID.
Body
required
StoreAddress request.
-
The body object of this method comprises two primary sections:
-
originatorBeneficiary
andvaspId
.
originatorBeneficiary
object
required
originator
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID.
Possible values: <= 255 characters
, Value must match regular expression ^([\p{L}\p{N}\s-/])*$
Represents the name of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-,.\s]*$
Represents the physical address of the originator.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the document number of the originator.
Represents the date of birth of the originator.
Possible values: <= 64 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the place of birth of the originator.
beneficiary
object
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the customer ID of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the name of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
Represents the wallet address of the beneficiary.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The VASP ID of the originator.
Possible values: <= 12 characters
, Value must match regular expression ^[a-zA-Z]{3,12}$
The asset ID.
Possible values: <= 128 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The transaction ID.
The amount associated with the transaction.
Possible values: <= 255 characters
, Value must match regular expression ^[a-zA-Z0-9-.\s]*$
The Virtual Asset Provider ID.
Responses
- 204
- 400
No Content
Bad Request