{"_id":"544aec7fa761f90800c41d32","editedParams":true,"editedParams2":true,"parentDoc":null,"category":{"_id":"543ee0c055bb1008000955b6","__v":21,"pages":["543ee1d615d0560800502749","543ee5c015d0560800502758","543ee87715d0560800502763","543ee9e315d056080050276c","543f003c55bb100800095624","543f030555bb10080009563f","543f0b3e15d05608005027ee","543f0d0755bb10080009566d","543f0e8415d056080050281b","543f0f8f55bb10080009567e","543f109055bb100800095689","543f11d315d056080050282b","543f15c615d0560800502845","544aec7fa761f90800c41d32","545a7fae1d018b1400227eff","545e9dc97e32310e00f400ca","5603c5dde416560d00fa63ad","564ed2eb9209cf0d001d6917","56cb2acb245b841300806ea4","56e05f414685db1700d9480b","56e063e4f97d422900d639bf"],"project":"543005c87d487022005b3fa8","version":"543005c87d487022005b3fab","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-15T21:01:52.185Z","from_sync":false,"order":1,"slug":"iwebcab-api-tools","title":"Gazoop Internal API"},"version":{"_id":"543005c87d487022005b3fab","__v":6,"project":"543005c87d487022005b3fa8","createdAt":"2014-10-04T14:35:52.362Z","releaseDate":"2014-10-04T14:35:52.362Z","categories":["543005c87d487022005b3fac","54345156edce04080040964e","543ee0c055bb1008000955b6","54c82a78ab706219009e0656","57390d0e1f4b740e00b06cb2","5741d5ab28f5fb0e0063ed36"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":1,"is_link":false,"project":"543005c87d487022005b3fa8","user":"543005a67d487022005b3fa7","updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-25T00:19:11.950Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"examples":{"codes":[]},"try":true,"method":"post","results":{"codes":[{"language":"json","status":200,"name":"","code":"{\n\t\"result\": \"valid\",\n  \"card_type\": \"MasterCard\",\n  \"l4d\": 5464,\n  \"expiry\": 0119,\n  \"valid_from\": 0116\n}"},{"code":"{\n\t\"result\" : \"error\",\n  \"error\" : \"Invalid Credit Card Information\"\n}","language":"json","status":400,"name":""}]},"settings":"","auth":"never","params":[{"_id":"544aec7fa761f90800c41d39","ref":"","in":"body","required":true,"desc":"This is a 25 alphanumeric hash code provided to you by the fleet.","default":"","type":"string","name":"api_key"},{"_id":"544aec7fa761f90800c41d38","ref":"","in":"body","required":true,"desc":"This is the mobile number for the customer account.","default":"","type":"int","name":"phone_number"},{"_id":"544aec7fa761f90800c41d36","ref":"","in":"body","required":true,"desc":"You can also send the customers PIN number for verification, if this fails, the API command will fail. If left blank, no validation is done on the authenticity of the customer ID.","default":"","type":"int","name":"customer_pin"},{"_id":"544aec7fa761f90800c41d35","ref":"","in":"body","required":true,"desc":"This is the full credit card number.","default":"","type":"string","name":"card_number"},{"_id":"544aec7fa761f90800c41d34","ref":"","in":"body","required":true,"desc":"This is the 4 digit number of the customers credit card expiration. For example, 0115 for January 2015 or 1116 for November 2016.","default":"","type":"string","name":"card_expiration"},{"_id":"544aec7fa761f90800c41d33","ref":"","in":"body","required":false,"desc":"This is the 4 digit number of the customers credit card valid from date - if none is available, please leave this field blank. For example, 0115 for January 2015 or 1116 for November 2016.","default":"","type":"string","name":"card_valid_from"}],"url":"/update_credit_card.json"},"isReference":false,"order":19,"body":"[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"PCI Compliance\",\n  \"body\": \"In order to be able to take advantage of this API you must have this feature turned on by iWebCab Tech Support after providing a PCI Compliance certificate. If, however, you are using a mobile app and connecting to us directly using HTTPS a PCI Compliance certificate is not required.\"\n}\n[/block]","excerpt":"Update or Add a Credit Card to a Customers account.","slug":"update_credit_card","type":"endpoint","title":"update_credit_card"}

postupdate_credit_card

Update or Add a Credit Card to a Customers account.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

api_key:
required
string
This is a 25 alphanumeric hash code provided to you by the fleet.
phone_number:
required
integer
This is the mobile number for the customer account.
customer_pin:
required
integer
You can also send the customers PIN number for verification, if this fails, the API command will fail. If left blank, no validation is done on the authenticity of the customer ID.
card_number:
required
string
This is the full credit card number.
card_expiration:
required
string
This is the 4 digit number of the customers credit card expiration. For example, 0115 for January 2015 or 1116 for November 2016.
card_valid_from:
string
This is the 4 digit number of the customers credit card valid from date - if none is available, please leave this field blank. For example, 0115 for January 2015 or 1116 for November 2016.

Result Format


Documentation

[block:callout] { "type": "danger", "title": "PCI Compliance", "body": "In order to be able to take advantage of this API you must have this feature turned on by iWebCab Tech Support after providing a PCI Compliance certificate. If, however, you are using a mobile app and connecting to us directly using HTTPS a PCI Compliance certificate is not required." } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}