{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Creating a personal payment source","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"creating-a-personal-payment-source","__idx":0},"children":["Creating a personal payment source"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The steps below explain how to create a personal payment source for a user profile."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"10%","data-label":"Step"},"children":["Step "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Name"},"children":["Name "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Endpoint"},"children":["Endpoint "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"50%","data-label":"Details"},"children":["Details "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/usersapi#operation/queryuser"},"children":["Query user"]}," (Optional)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/users"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query users using filters such as the company ID, TMC ID, or the user’s email. This is an optional step to obtain the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," of the user.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Querying users using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyId"]}," or the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tmcId"]}," will list all users associated with the company or TMC. You’ll need to identify the specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," for which the payment source needs to be mapped.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response will contain:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other APIs will use:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/paymentsapi#operation/createpersonalpaymentsource"},"children":["Create personal payment source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payment/users/{userId}/payment-sources"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a personal payment source for a user.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," For creating a personal payment source, you must use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vault.spotnana.com"]}," host URL along with the endpoint. In this step the complete API URL will be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vault.spotnana.com/v2/payment/users/{userId}/payment-sources"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL path requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," from step 1.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request body requires:"]}," Payment source type, card details, and managed traveler access settings if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," is an arranger.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response body contains:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSourceId"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other APIs will use:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSourceId"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/paymentsapi#operation/getpersonalpaymentsource"},"children":["Get the personal payment source"]}," (Optional)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payment/users/{userId}/payment-sources/{paymentSourceId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve the details of a personal payment source. This endpoint can be used to check the status of the payment source. If the status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INCOMPLETE"]},", ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/spotnana/personal_payment_updation"},"children":["update the personal payment source"]}," with the missing information.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The response will never contain the card number. Instead, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSource"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," field will contain the masked information.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL path requires:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," from step 1 and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSourceId"]}," from step 2."]}]}]}]}]}]},"headings":[{"value":"Creating a personal payment source","id":"creating-a-personal-payment-source","depth":1}],"frontmatter":{"seo":{"title":"Creating a personal payment source"}},"lastModified":"2025-03-26T13:40:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/spotnana/personal_payment_creation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}