{"id":131,"date":"2016-01-26T16:39:41","date_gmt":"2016-01-26T16:39:41","guid":{"rendered":"http:\/\/192.168.114.129\/?page_id=131"},"modified":"2026-04-20T17:21:17","modified_gmt":"2026-04-20T17:21:17","slug":"payment-processing","status":"publish","type":"page","link":"https:\/\/api-users.4over.com\/?page_id=131","title":{"rendered":"Payment Processing"},"content":{"rendered":"

Get customer’s payment profiles:<\/h3>\n
\nGET  \/paymentprofiles\n<\/pre>\n
Sample Response:<\/h3>\n
JSON<\/p>\n
\n{\n   "entities": [{\n         "profile_token": "xxxxxxxxxx",\n         "last_four": "xxxx",\n         "type": "Visa"\n      },\n      {\n         "profile_token": "yyyyyyyyyyy",\n         "last_four": "yyyy",\n         "type": "Master"\n      }\n   ]\n}\n<\/pre>\n
Save the desired payment profile and post the order.<\/p>\n
How to Add New Payment Profiles<\/h3>\n
1) First Login into the site 4over.com<\/a>
\n2) Then go to Account->Orders & Account->Stored Payment Methods<\/strong>
\n3) Then Click on Add New Card<\/strong>.
\n4) Now hit the \/paymentprofiles API. You can see the added card in the response.<\/p>\n
Note<\/strong>: If you added credit cards to your 4Over account before generating API keys, those cards will not appear when calling the \/paymentprofiles API.
\nTo resolve this, you can either:
\n – Add a new credit card after generating your API keys, or
\n – Remove the existing card from the 4over.com website and re-enter the credit card details to create a new payment profile and sync with the API.<\/p>\n
Payment Processing<\/h3>\n
To process payments add the Payment block to the order POST.
\nThe requested amount is not required. The amount is calculated internally and matched against the amount passed by the user. If this parameter is excluded the calculated amount will be charged to the credit card on file by way of the provided payment token. Please note that “requested_amount” must be excluded from payment block for this to work correctly. If this parameter is present with 0 or null value the order will fail.<\/p>\n
Orders\u00a0 Payment\u00a0using Credit Card Processing<\/h3>\n
\nPOST  \/orders\n<\/pre>\n
Input Parameters<\/h3>\n
These are in addition to order parameters above.<\/h4>\n
\n@param profile_token.\n<\/pre>\n
Sample Request<\/h3>\n
html<\/p>\n
\nhttps:\/\/api.4over.com\/orders\n<\/pre>\n
Sample Request Body<\/h3>\n
JSON<\/p>\n
\n\u00a0 {\n  "order_id": "test001",\n  "is_test_order": "true",\n  "coupon_code": "PRC5PKS",\n  "skip_conformation": "true",\n  "jobs": [\n    {\n      "product_uuid": "91efff4d-de64-410a-8794-fc547022a7f2",\n      "runsize_uuid": "52e3d710-0e8f-4d4d-8560-7d4d8655be69",\n      "option_uuids": [],\n      "turnaroundtime_uuid": "50979118-b3a2-4556-9f46-d1da268f2354",\n      "colorspec_uuid": "13abbda7-1d64-4f25-8bb2-c179b224825d",\n      "dropship": "true",\n      "sets": 2,\n      "files": {\n        "set_001": {\n          "job_name": "job001-001",\n          "files": {\n            "fr": "5a2e207c-8a97-42a3-9b17-1e4899eae9ac",\n            "bk": "d044410f-003e-4b32-8039-f6d590728f5b"\n          }\n        },\n        "set_002": {\n          "job_name": "job001-002",\n          "files": {\n            "fr": "8b0fd851-7f13-4700-a35a-baff123eecfe",\n            "bk": "3d71bf4a-a799-4dfb-ac90-8fea5f97b608"\n          }\n        }\n      },\n      "ship_to": {\n        "company": "My Print Company",\n        "firstname": "James",\n        "lastname": "Doe",\n        "email": "james.doe@abcd_company.com",\n        "phone": "888-888-8888",\n        "address": "8900 Executive Park Drive",\n        "address2": "",\n        "city": "Knoxville",\n        "state": "TN",\n        "zipcode": "37923",\n        "country": "US"\n      },\n      "ship_from": {\n        "company": "My Print Company",\n        "firstname": "Mike",\n        "lastname": "Doe",\n        "email": null,\n        "phone": "888-888-8888",\n        "address": "100 CUMMINGS CTR",\n        "address2": null,\n        "city": "BEVERLY",\n        "state": "MA",\n        "zipcode": "01915",\n        "country": "US"\n      },\n      "shipper": {\n        "shipping_method": "FREE UPS Ground",\n        "shipping_code": "03f"\n      },\n      "ship_from_facility": "DAY"\n    },\n    {\n      "product_uuid": "91efff4d-de64-410a-8794-fc547022a7f2",\n      "runsize_uuid": "52e3d710-0e8f-4d4d-8560-7d4d8655be69",\n      "option_uuids": [],\n      "turnaroundtime_uuid": "50979118-b3a2-4556-9f46-d1da268f2354",\n      "colorspec_uuid": "13abbda7-1d64-4f25-8bb2-c179b224825d",\n      "dropship": "true",\n      "sets": 3,\n      "files": {\n        "set_001": {\n          "job_name": "job002-001",\n          "files": {\n            "fr": "62a7d70a-3b38-45a8-9327-e10a9c4057df",\n            "bk": "ef45e3ff-2f3c-415c-8c63-4f5e3f290e8d"\n          }\n        },\n        "set_002": {\n          "job_name": "job002-002",\n          "files": {\n            "fr": "bad3efad7-2e72-4a5e-87ec-d8bad3ef0359",\n            "bk": "f9ead3ef0-b0de-4033-ad6d-aa15aa8c2555"\n          }\n        },\n        "set_003": {\n          "job_name": "job002-003",\n          "files": {\n            "fr": "3830c3ee-72e4-46d7-8d0d-aad3ef77ccf1",\n            "bk": "bd380570-135d-47fd-9411-b3ead3ef99d8"\n          }\n        }\n      },\n      "ship_to": {\n        "company": "My Test Company",\n        "firstname": "Maria",\n        "lastname": "Doe",\n        "email": "maria.doe@abcd_company.com",\n        "phone": "888-888-8888",\n        "address": "8900 Executive Park Drive",\n        "address2": null,\n        "city": "Knoxville",\n        "state": "TN",\n        "zipcode": "37923",\n        "country": "US"\n      },\n      "ship_from": {\n        "company": "My Print Company",\n        "firstname": "Mike",\n        "lastname": "Doe",\n        "email": null,\n        "phone": "888-888-8888",\n        "address": "100 CUMMINGS CTR",\n        "address2": null,\n        "city": "BEVERLY",\n        "state": "MA",\n        "zipcode": "01915",\n        "country": "US"\n      },\n      "shipper": {\n        "shipping_method": "FREE UPS Ground",\n        "shipping_code": "03f"\n      },\n      "ship_from_facility": "DAY"\n    }\n  ],\n  "payment": {\n    "profile_token": "xxxxxxxxxx"\n  }\n}<\/pre>\n
Sample Response<\/h3>\n
JSON<\/p>\n
\n{\n  "order_status": "Success",\n  "customer_order_id": "test001",\n  "job_ids": {\n    "X8291118499-001": {\n      "customer_job_id": "job001-001",\n      "status": 200,\n      "messages": []\n    },\n    "X8291118499-002": {\n      "customer_job_id": "job001-002",\n      "status": 200,\n      "messages": []\n    },\n    "X8291118499-003": {\n      "customer_job_id": "job002-001",\n      "status": 200,\n      "messages": []\n    },\n    "X8291118499-004": {\n      "customer_job_id": "job002-002",\n      "status": 200,\n      "messages": []\n    },\n    "X8291118499-005": {\n      "customer_job_id": "job002-003",\n      "status": 200,\n      "messages": []\n    }\n  },\n  "payment_response": {\n    "payment_uuid": "e58bee7f-0b57-4214-9e2a-33d683e7fe9f",\n    "payment_provider": {\n      "payment_provider_uuid": "6b0e699e-bdaf-4d1e-af4c-bc422ad21761",\n      "payment_provider": "Authorizenet",\n      "created_at": "2013-11-05 11:33:51-08"\n    },\n    "requested_amount": "119.70",\n    "requested_currency": {\n      "currency_code": "USD",\n      "currency": "United States dollar",\n      "currency_number": "840",\n      "created_at": "2013-09-30 09:27:22.689216-07"\n    },\n    "request_transaction_code": "12345678920",\n    "request_data": "",\n    "requested_at": "2018-10-18T18:06:19+0000",\n    "response_transaction_code": "12345678920",\n    "response_data": {\n      "card_number": "XXXX1111",\n      "card_type": "Visa",\n      "response_message": "This transaction has been approved."\n    },\n    "responded_at": "2018-10-18T18:06:19+0000",\n    "authorization_code": "ABCDEF",\n    "authorized_at": "2018-10-18T18:06:19+0000",\n    "authorized_payment_amount": "119.70",\n    "authorized_refund_amount": 0,\n    "authorized_currency": {\n      "currency_code": "USD",\n      "currency": "United States dollar",\n      "currency_number": "840",\n      "created_at": "2013-09-30 09:27:22.689216-07"\n    },\n    "paying_organization": {\n      "organization_uuid": "a4377724-8819-4a96-bc2b-3877b269f989",\n      "organization_name": "4over",\n      "organization_description": "4over Website - Trade Ultra",\n      "job_code_prefix": "K",\n      "is_public_organization": true,\n      "primary_contact_user": {\n        "user_uuid": "d44fa923-d567-48ed-aa3a-9c02a98bcee6",\n        "first_name": "Admin User",\n        "last_name": "API",\n        "email": "",\n        "user_notes": "admin user",\n        "created_at": "2014-03-18 12:33:43.387423-07",\n        "updated_at": "2015-07-06 10:29:18.338875-07",\n        "deleted_at": "",\n        "organizations": "https:\/\/sandbox-api.4over.com\/users\/d44fa923-d567-48ed-aa3a-9c02a98bcee6\/organizations",\n        "logins": "https:\/\/sandbox-api.4over.com\/users\/d44fa923-d567-48ed-aa3a-9c02a98bcee6\/logins",\n        "token": "5ec64e96d3877374fd35c2aae94cea3d07b83e10",\n        "timestamp": "0.09669000 1539885980",\n        "current_organization_uuid": "a4377724-8819-4a96-bc2b-3877b269f989"\n      },\n      "parent_organization": {\n        "organization_uuid": "8a17ef16-d997-4544-9f7c-d313febf9c40",\n        "organization_name": "4over root",\n        "organization_description": "4over root",\n        "job_code_prefix": "Z",\n        "is_public_organization": true,\n        "primary_contact_user": {\n          "user_uuid": "cb51b9fc-6a6e-4b98-885f-5d21041c1403",\n          "first_name": "Jane",\n          "last_name": "Doe",\n          "email": "fake@4over.com",\n          "user_notes": "test",\n          "created_at": "2012-09-10 07:00:00.000000+0000",\n          "updated_at": "2018-05-31 15:48:19.140525-07",\n          "deleted_at": "",\n          "organizations": "https:\/\/sandbox-api.4over.com\/users\/cb51b9fc-6a6e-4b98-885f-5d21041c1403\/organizations",\n          "logins": "https:\/\/sandbox-api.4over.com\/users\/cb51b9fc-6a6e-4b98-885f-5d21041c1403\/logins",\n          "token": "47a11796c675bbde6e3215239cd1a4c76255e854",\n          "timestamp": "0.09683600 1539885980",\n          "current_organization_uuid": "a4377724-8819-4a96-bc2b-3877b269f989"\n        }\n      }\n    },\n    "paying_user": {\n      "user_uuid": "0e153dc0-9b7b-47e8-8cfd-e50d88817ffb",\n      "first_name": "Test",\n      "last_name": "Tester",\n      "email": "fake@4over.com",\n      "user_notes": "testing ",\n      "created_at": "2013-08-26 07:00:00.000000+0000",\n      "updated_at": "2018-05-31 15:48:19.773569-07",\n      "deleted_at": "",\n      "organizations": "https:\/\/sandbox-api.4over.com\/users\/0e153dc0-9b7b-47e8-8cfd-e50d88817ffb\/organizations",\n      "logins": "https:\/\/sandbox-api.4over.com\/users\/0e153dc0-9b7b-47e8-8cfd-e50d88817ffb\/logins",\n      "token": "19253d572c2e5db795b4a8c846135218587c065b",\n      "timestamp": "0.09695700 1539885980",\n      "current_organization_uuid": "a4377724-8819-4a96-bc2b-3877b269f989"\n    },\n    "created_at": "2018-10-18T18:06:19+0000"\n  },\n  "payment_type": "authnet"\n}<\/pre>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Get customer’s payment profiles: Sample Response: JSON Save the desired payment profile and post the order. How to Add New Payment Profiles 1) First Login into the site 4over.com 2) Then go to Account->Orders & Account->Stored Payment Methods 3) Then Click on Add New Card. 4) Now hit the \/paymentprofiles API. You can see the […]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":129,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-131","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/pages\/131","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/api-users.4over.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=131"}],"version-history":[{"count":89,"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/pages\/131\/revisions"}],"predecessor-version":[{"id":1156,"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/pages\/131\/revisions\/1156"}],"up":[{"embeddable":true,"href":"https:\/\/api-users.4over.com\/index.php?rest_route=\/wp\/v2\/pages\/129"}],"wp:attachment":[{"href":"https:\/\/api-users.4over.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=131"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}