Skip to content

Create Personal Payment Source.

Request

API to Create Personal Payment Source

Security
Bearer
Path
userIdstring, (uuid)required

Identifier for User Profile

Example:4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/json
paymentSourceInfoobject(PaymentSourceInfoV2)required

Detailed information about the payment source to be created.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/payment/users/4974a66b-7493-4f41-908c-58ba81093947/payment-sources \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "paymentSourceInfo": {
      "paymentSource": {
        "type": "CARD",
        "card": {
          "company": "VISA",
          "name": "Harrison Schwartz",
          "address": {
            "addressLines": [
              "Golden Gate Bridge"
            ],
            "administrativeArea": "CA",
            "administrativeAreaName": "California",
            "description": "San Francisco Home",
            "isDefault": true,
            "languageCode": "en",
            "locality": "San Francisco",
            "locationCode": "LAX",
            "organization": "Spotnana",
            "postalCode": "94130",
            "continentCode": "AF",
            "recipients": [
              "string"
            ],
            "regionCode": "US",
            "regionName": "America",
            "revision": 1,
            "sortingCode": "Jamaica",
            "sublocality": "string",
            "timezone": "America/Los_Angeles",
            "coordinates": {
              "latitude": 77.1025,
              "longitude": 28.7041
            }
          },
          "number": "4111111111111111",
          "cvv": "012",
          "label": "Label amex",
          "expiry": {
            "expiryMonth": 1,
            "expiryYear": 2010
          },
          "ownershipLabel": "PERSONAL"
        }
      },
      "filter": {
        "type": "PERSONAL",
        "travelTypes": [
          "AIR"
        ],
        "managedTravelerAccess": {
          "enabled": false,
          "visibility": {
            "showToTravelers": false
          }
        }
      },
      "externalId": "bxt_RNGsNfzgJDaTstKIKqK4xEuhGYAnMdYK8T40"
    }
  }'

Responses

OK

Bodyapplication/json
idstring, (uuid)

Unique identifier identifying the created payment source, if created.

Example:"f49d00fe-1eda-4304-ba79-a980f565281d"
statusstring(PaymentSourceStatus)read-only

Current status of the payment source.

Enum:"ACTIVE""INCOMPLETE""TEMPORARY_READY""TEMPORARY_USED""TEMPORARY_EXPIRED""TEMPORARY_INCOMPLETE"
authenticationInfoobject(AuthenticationInfo)

Information required for additional authentication steps, such as 3D Secure verification.

Response
{ "id": "f49d00fe-1eda-4304-ba79-a980f565281d", "status": "ACTIVE", "authenticationInfo": { "authUrl": "string" } }