External assets are Assets API which are issued by a third-party.
/api/external-assets
Load an asset from a supported third-party issuer. Asset details will be obtained from the issuer.
Attributes
accountId
category
type
issuer
externalId
pin
description
Errors
UNKNOWN_ASSET
DUPLICATE_ASSET
UNSUPPORTED_ASSET_TYPE
DENIED_BY_ASSET_PROVIDER
EXPIRED_BY_ASSET_PROVIDER
Request
curl -X POST \
https://service.centrapay.com/api/external-assets \
-H 'content-type: application/json' \
-H 'x-api-key: <TOKEN>' \
-d '
{
"accountId": "Jaim1Cu1Q55uooxSens6yk",
"category": "giftcard",
"type": "epay.nzd.test",
"issuer": "ezipay",
"externalId": "23403321042",
"pin": "3771"
}
'
Response
{
"id": "L75M3L56N2PtBSt8g7uXLU",
"category": "giftcard",
"type": "epay.nzd.main",
"accountId": "Jaim1Cu1Q55uooxSens6yk",
"issuer": "ezipay",
"externalId": "************21042",
"description": "$60 Acme Giftcard",
"productCode": "23403",
"currency": "NZD",
"initialBalance": "7000",
"balance": "6000",
"availableBalance": "6000",
"balanceUpdatedAt": "2020-06-10T15:30:00.000Z",
"expiresAt": "2020-12-31T00:00:00.000Z",
"createdAt": "2020-05-01T12:30:00.000Z"
}