Create Customer Profile

A Create Customer Profile request stores a customer's billing and payment information in PayTrace's PCI-compliant Customer Database(Vault) for your account. This request will allow you to assign a customer ID(token) to eliminate your software from storing sensitive payment information.

This request can use encrypted values (encrypted_number and encrypted_csc) that were encrypted by the PayTrace Client-Side Encryption JavaScript Library.

Request

Response

POST: /v1/customer/create

REQUEST:

{
  "customer_id": "customer456",
  "credit_card": {
    "number": "4111111111111111",
    "expiration_month": "12",
    "expiration_year": "2020"
  },
  "billing_address": {
    "name": "Steve Smith",
    "street_address": "8320 E. West St.",
    "city": "Spokane",
    "state": "WA",
    "zip": "85284"
  }
}

With Client Side Encrypted Data

{
  "customer_id": "customer456",
  "credit_card": {
    "encrypted_number": "htpAmr1TJ2hujwO/ObS8oFG3/AhF3AU0zh4QzgynFJejRxUOoyJ1MTXW54UD6F2cvuDCgLLMjYu1K8ybAX/Ap4HvsthqdMz5lYhDj1GwcDBUnZQx+upD/8gZNUHnm5S4EZkAXMNT79iwLCd++X97yOatd3jhjxaC0zdRUABYr6PuVEYa7gXTEO3LIiOuAnoLVhrD7ZPni8dnCluyIk2z2k6OwDdCYFwvgpuuZ/luRboG07uYBm1TfHnrLkuCGOxeP7B8Aa0rY1du7GFwXxYadI21AqrgM+DCJLfX156lil0gL4D/ZMQoTIr1hqDr9WKv92V3M+H6Gsx7z0iCbn+8Ug==",
    "expiration_month": "12",
    "expiration_year": "2020"
  },
  "billing_address": {
    "name": "Steve Smith",
    "street_address": "8320 E. West St.",
    "city": "Spokane",
    "state": "WA",
    "zip": "85284"
  }
}

Field types: R – Required, O – Optional, C - Conditional

RESPONSE:

{
  "success": true,
  "response_code": 160,
  "status_message": "The customer profile for customer456/Steve Smith was successfully created.",
  "customer_id": "customer456",
  "masked_card_number": "xxxxxxxxxxxx1111"
}