{ "info": { "_postman_id": "9815a663-e0ed-4bcc-a68a-b0c13777044b", "name": "Authentication ACH Returns Payins API", "description": "This resource is used for authentication actions\n\nContact Support:\n Name: Rainforest\n Email: support@rainforestpay.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:43:42.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "lastUpdatedBy": "35240", "uid": "35240-9815a663-e0ed-4bcc-a68a-b0c13777044b" }, "item": [ { "name": "v1", "item": [ { "name": "payins", "item": [ { "name": "{payin_id}", "item": [ { "name": "metadata", "item": [ { "name": "Update payin metadata", "id": "2b4f6c42-e175-411d-9d56-3cc10434b4a2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "id": "8a997883-c864-438b-b81a-48cea9f581d9", "key": "payin_id", "value": "", "description": "(Required) The unique payin identifier. \n\nPrefix is \"pyi\" in production and \"sbx_pyi\" in sandbox." } ] }, "description": "The body of the request is the JSON key-value metadata to patch to the payin. Do not use the metadata field to store sensitive or confidential data. \n\nUpdating metadata will merge with the existing metadata stored on the chargeback by the top-level key. If the same top-level key is passed in this request, it will overwrite the value stored on the chargeback. Only keys included in the payload will be updated. To remove a key, set the key's value to null. To remove all metadata pass null for the metadata value.\n\nPayin metadata must be less than 8 KB in size.\n\nPayin metadata can only be updated using an API key. This request should not be made by your frontend and should only be done by backend logic that only the platform can complete." }, "response": [ { "id": "442059d5-dfa9-459f-91ce-ba73283839b2", "name": "OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"NET\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"FAILED\",\n \"status\": \"RETURNED\",\n \"refusal_code\": \"DECLINED\",\n \"refusal_desc\": \"Retry with 3DS\",\n \"detailed_refusal_code\": \"INSUFFICIENT_FUNDS\",\n \"detailed_refusal_desc\": \"Risk decline\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"VENMO\",\n \"card\": {\n \"type\": \"CREDIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"American Express\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Discover\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"BUSINESS\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"KEYED\",\n \"verification_type\": \"SIGNATURE\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"FINGERPRINTED\",\n \"failed_reason_code\": \"UNEXPECTED_ERROR\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"EXTERNAL\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-442059d5-dfa9-459f-91ce-ba73283839b2" }, { "id": "fa53aecc-5964-4f0b-9b17-ddfd5972b2c6", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-fa53aecc-5964-4f0b-9b17-ddfd5972b2c6" }, { "id": "db2e8d76-28d2-42a6-96c0-cfc1b75ee358", "name": "Authorization missing or invalid.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-db2e8d76-28d2-42a6-96c0-cfc1b75ee358" }, { "id": "9b8e5637-39c5-4b15-bbc7-4f9093b0ded1", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-9b8e5637-39c5-4b15-bbc7-4f9093b0ded1" }, { "id": "ad6c7b29-bb6f-4cf0-8550-bddcc99e6e18", "name": "Resource not found.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-ad6c7b29-bb6f-4cf0-8550-bddcc99e6e18" }, { "id": "2475faa8-ac9b-4297-a8e3-84ec76ab7694", "name": "Unexpected error.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/metadata", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "metadata" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-2475faa8-ac9b-4297-a8e3-84ec76ab7694" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-2b4f6c42-e175-411d-9d56-3cc10434b4a2" } ], "id": "6c70b3c4-850a-49f2-bdfd-af6861c117c0", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-6c70b3c4-850a-49f2-bdfd-af6861c117c0" }, { "name": "capture", "item": [ { "name": "Capture payin", "id": "62740f62-7a49-4ece-9c5c-873784c1b724", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "id": "ad63f2cc-8de0-4be7-831f-daa8eddad17c", "key": "payin_id", "value": "", "description": "(Required) The unique payin identifier. \n\nPrefix is \"pyi\" in production and \"sbx_pyi\" in sandbox." } ] }, "description": "Capture an authorized payin. The payin status must be Authorized to capture." }, "response": [ { "id": "38fc1e28-5e2d-44b2-a0e6-92ef83e93f0b", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"NET\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"FAILED\",\n \"status\": \"RETURNED\",\n \"refusal_code\": \"DECLINED\",\n \"refusal_desc\": \"Retry with 3DS\",\n \"detailed_refusal_code\": \"INSUFFICIENT_FUNDS\",\n \"detailed_refusal_desc\": \"Risk decline\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"VENMO\",\n \"card\": {\n \"type\": \"CREDIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"American Express\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Discover\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"BUSINESS\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"KEYED\",\n \"verification_type\": \"SIGNATURE\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"FINGERPRINTED\",\n \"failed_reason_code\": \"UNEXPECTED_ERROR\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"EXTERNAL\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-38fc1e28-5e2d-44b2-a0e6-92ef83e93f0b" }, { "id": "25e39382-ca6a-439f-bfeb-4124c4306d51", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-25e39382-ca6a-439f-bfeb-4124c4306d51" }, { "id": "2d003a1e-c450-4ae2-b2eb-656a8615a57f", "name": "Authorization missing or invalid.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-2d003a1e-c450-4ae2-b2eb-656a8615a57f" }, { "id": "a3265985-d8ca-4fa4-a7a9-789e13f17396", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-a3265985-d8ca-4fa4-a7a9-789e13f17396" }, { "id": "815ef8c3-b50e-49b1-9a13-2e6ccb321eff", "name": "Resource not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-815ef8c3-b50e-49b1-9a13-2e6ccb321eff" }, { "id": "03270bc7-c478-4417-b301-37f760422843", "name": "Unexpected error.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"metadata\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "capture" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-03270bc7-c478-4417-b301-37f760422843" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-62740f62-7a49-4ece-9c5c-873784c1b724" } ], "id": "20a238d5-713e-47ac-a83d-268bd1f03bd3", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-20a238d5-713e-47ac-a83d-268bd1f03bd3" }, { "name": "void_or_refund", "item": [ { "name": "Void or refund payin", "id": "7f43f771-7114-42ec-a06d-10ce04309213", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "id": "2a6bb225-469a-4da2-bef2-67aa5fe13bea", "key": "payin_id", "value": "", "description": "(Required) The unique payin identifier. \n\nPrefix is \"pyi\" in production and \"sbx_pyi\" in sandbox." } ] }, "description": "Void or refund a payin by the payin ID.\n\nIf the payin status is `Processing`, then the full payin amount can be voided. A payin cannot be partially voided. If the payin status is `Succeeded`, then the payin can be fully or partially refunded. See the payin `refundable_amount` and `non_refundable_reason_code` for details on if the payin is eligible for a void or refund." }, "response": [ { "id": "4a2f1990-50f2-4241-8c06-4893f6258efc", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {\n \"type\": \"VOID\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"refund_id\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data/properties/refund_id not found in the OpenAPI spec\"\n },\n \"refund_status\": \"PROCESSING\",\n \"payin_id\": \"\",\n \"payin_status\": \"SUCCEEDED\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data/properties/amount_splits not found in the OpenAPI spec\"\n },\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n },\n \"reason\": \"FRAUDULENT\",\n \"refusal_code\": \"RETRY_WITH_THREEDS\",\n \"refusal_desc\": \"Stolen card\",\n \"auth_code\": \"\",\n \"metadata\": {},\n \"source\": \"EXTERNAL\",\n \"created_at\": \"\"\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-4a2f1990-50f2-4241-8c06-4893f6258efc" }, { "id": "d73b7a8b-8e01-4cb9-a949-2ec9a4c36ace", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-d73b7a8b-8e01-4cb9-a949-2ec9a4c36ace" }, { "id": "88baef2c-e5e8-4033-965f-54d2df5e92dc", "name": "Authorization missing or invalid.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-88baef2c-e5e8-4033-965f-54d2df5e92dc" }, { "id": "3eafd9c7-ad18-4a86-9b94-cc481f20dc74", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-3eafd9c7-ad18-4a86-9b94-cc481f20dc74" }, { "id": "1ff2f82d-70a8-421d-8847-26a66965b224", "name": "Resource not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-1ff2f82d-70a8-421d-8847-26a66965b224" }, { "id": "221ac32e-03c5-4d59-93ec-b96f2e56f9e2", "name": "409 response", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-221ac32e-03c5-4d59-93ec-b96f2e56f9e2" }, { "id": "99542c51-70cf-4b15-95bc-6b7d9d612d6f", "name": "Unexpected error.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"DUPLICATE\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"merchant_billing\": {\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"fee\": \"\",\n \"currency_code\": \"USD\"\n },\n \"metadata\": {},\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"rate\": \"\",\n \"rate_cap\": \"\",\n \"merchant_id\": \"\"\n }\n ],\n \"payin_billing_fees_reversal_config\": {\n \"on_full_refund\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id/void_or_refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id", "void_or_refund" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-99542c51-70cf-4b15-95bc-6b7d9d612d6f" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-7f43f771-7114-42ec-a06d-10ce04309213" } ], "id": "15bcc419-3793-4274-b1f7-83f21c8362ae", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-15bcc419-3793-4274-b1f7-83f21c8362ae" }, { "name": "Get payin", "id": "c4466efa-36df-45bc-aaba-7116dcc873c2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "id": "6cd805ee-a04e-4286-8629-4d0c4ff00b5e", "key": "payin_id", "value": "", "description": "(Required) The unique payin identifier. \n\nPrefix is \"pyi\" in production and \"sbx_pyi\" in sandbox." } ] }, "description": "Get payin details by the payin ID." }, "response": [ { "id": "4ee8e50c-509e-4c34-945f-06f467b00a02", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"NET\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"FAILED\",\n \"status\": \"RETURNED\",\n \"refusal_code\": \"DECLINED\",\n \"refusal_desc\": \"Retry with 3DS\",\n \"detailed_refusal_code\": \"INSUFFICIENT_FUNDS\",\n \"detailed_refusal_desc\": \"Risk decline\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"VENMO\",\n \"card\": {\n \"type\": \"CREDIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"American Express\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Discover\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"BUSINESS\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"KEYED\",\n \"verification_type\": \"SIGNATURE\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"FINGERPRINTED\",\n \"failed_reason_code\": \"UNEXPECTED_ERROR\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"EXTERNAL\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-4ee8e50c-509e-4c34-945f-06f467b00a02" }, { "id": "d5589d8c-f610-439f-823d-76ab746bf59d", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-d5589d8c-f610-439f-823d-76ab746bf59d" }, { "id": "19edbb64-d9e6-41c6-a742-e5bacff8d759", "name": "Authorization missing or invalid.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-19edbb64-d9e6-41c6-a742-e5bacff8d759" }, { "id": "ee0caa4b-0eb3-44f8-adce-8210b098d4be", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-ee0caa4b-0eb3-44f8-adce-8210b098d4be" }, { "id": "950c7073-fdb3-4cb6-8124-9aaf3078907f", "name": "Resource not found.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-950c7073-fdb3-4cb6-8124-9aaf3078907f" }, { "id": "5d8bb0e9-8a7d-4826-961f-9881bbaefc1d", "name": "Unexpected error.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins/:payin_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins", ":payin_id" ], "variable": [ { "key": "payin_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-5d8bb0e9-8a7d-4826-961f-9881bbaefc1d" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-c4466efa-36df-45bc-aaba-7116dcc873c2" } ], "id": "bee301da-fb78-4b52-ae2a-99fcf17775b5", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-bee301da-fb78-4b52-ae2a-99fcf17775b5" }, { "name": "List payins", "id": "cdea1267-5640-41db-ada7-21e1f5e76dc8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=FAILED&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "FAILED" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] }, "description": "Query a list of payins given optional search criteria." }, "response": [ { "id": "a64ad242-2b51-4264-ad75-29a27a5c1c3b", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {\n \"total_results\": \"\",\n \"last_key\": {\n \"name\": \"last_key\",\n \"schema\": \"exercitation commodo ad anim laboris\",\n \"description\": \"Last ID in this result set.\\n\\nThis value can be be used as `start_key` in subsequent paginated requests to retrieve additional results whose IDs are greater than the `last_key` value.\"\n },\n \"results\": [\n {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"GROSS\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"HAS_CHARGEBACKS\",\n \"status\": \"SUCCEEDED\",\n \"refusal_code\": \"UNEXPECTED_PAYIN_TOKEN\",\n \"refusal_desc\": \"No card number on file with issuer\",\n \"detailed_refusal_code\": \"NO_SUCH_CARD_ISSUER\",\n \"detailed_refusal_desc\": \"No card number on file with issuer\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"VENMO\",\n \"card\": {\n \"type\": \"CREDIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Visa\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"PREPAID\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"American Express\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"SAVINGS\",\n \"account_holder_type\": \"BUSINESS\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"INVALID\",\n \"verification_type\": \"NONE\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"CREATED\",\n \"failed_reason_code\": \"UNSUPPORTED_PAYMENT_DATA\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"IVR\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"GROSS\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"FULLY_REFUNDED\",\n \"status\": \"PROCESSING\",\n \"refusal_code\": \"null\",\n \"refusal_desc\": \"Retry\",\n \"detailed_refusal_code\": \"INCORRECT_PAYMENT_INFORMATION\",\n \"detailed_refusal_desc\": \"Processing error\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"PLATFORM\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"ACH\",\n \"card\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Discover\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Visa\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"KEYED\",\n \"verification_type\": \"OFFLINE_PIN\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"FAILED\",\n \"failed_reason_code\": \"MERCHANT_NOT_BOARDED\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"API_DIRECT\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n }\n ]\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-a64ad242-2b51-4264-ad75-29a27a5c1c3b" }, { "id": "8e88b96b-fcb8-4dd0-9d2e-84a9b7180a51", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-8e88b96b-fcb8-4dd0-9d2e-84a9b7180a51" }, { "id": "db3bab46-6a22-4510-917c-294e2e368a4f", "name": "Authorization missing or invalid.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-db3bab46-6a22-4510-917c-294e2e368a4f" }, { "id": "367d7ce6-0c0a-431c-8998-29282cfe186a", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-367d7ce6-0c0a-431c-8998-29282cfe186a" }, { "id": "6c01d92a-6dfc-4e40-9948-1ac12953312a", "name": "Unexpected error.", "originalRequest": { "method": "GET", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/payins?merchant_name=&method_type=APPLE_PAY&billing_contact_name=&status=IN_REVIEW&source=API_STORED_PAYMENT_METHOD&metadata=&created_at.start=&created_at.end=&expected_deposit_date.start=&expected_deposit_date.end=&sort_by=payin_id&sort_order=desc&limit=1000&start_key=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ], "query": [ { "description": "Optional merchant name by which to filter.", "key": "merchant_name", "value": "" }, { "description": "Payment method type to filter by. Provide parameter multiple times to filter by multiple payment method types.", "key": "method_type", "value": "APPLE_PAY" }, { "description": "Optional billing contact name by which to filter.", "key": "billing_contact_name", "value": "" }, { "description": "One or more payin statuses to filter by. Provide parameter multiple times to filter by multiple payin status types.\n\n`AUTHORIZED` `CANCELED` `CREATED` `FAILED` `IN_REVIEW` `PRESENTING` `PROCESSING` `RETURNED` `SUCCEEDED`", "key": "status", "value": "IN_REVIEW" }, { "description": "One or more payin sources to filter by. Provide parameter multiple times to filter by multiple payin sources. ", "key": "source", "value": "API_STORED_PAYMENT_METHOD" }, { "description": "Filter by metadata stored on the entity by passing a map of key-value pairs to filter on. The `key` should be valid JSONPath to a corresponding metadata key.\n\nFor example, an entity created with the following metadata\n```\n\"account\": {\n \"id\": \"acct_123\"\n}\n```\ncould have the following metadata filter to find entities with the metadata account id: \n```\n?metadata[$.account.id]=acct_123\n```", "key": "metadata", "value": "" }, { "description": "Created on or after in UTC RFC 3339 format.", "key": "created_at.start", "value": "" }, { "description": "Created on or before in UTC RFC 3339 format.", "key": "created_at.end", "value": "" }, { "description": "Expected to be deposited on or after in UTC RFC 3339 format.", "key": "expected_deposit_date.start", "value": "" }, { "description": "Expected to be deposited on or before in UTC RFC 3339 format.", "key": "expected_deposit_date.end", "value": "" }, { "description": "Optional value by which to sort the result set. Default sort by is created_at.", "key": "sort_by", "value": "payin_id" }, { "description": "Order in which to return the sorted results; ascending or descending. Default sort order is descending.", "key": "sort_order", "value": "desc" }, { "description": "The maximum number of results to return.", "key": "limit", "value": "1000" }, { "description": "A key used to indicate the starting point for the next page of results. This value should be set to the last_key returned by the previous paginated request.", "key": "start_key", "value": "" }, { "description": "Offset has been deprecated. Utilize start_key and last_key for pagination.\n\nThe offset of the first result to return; zero-based.", "key": "offset", "value": "0" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-6c01d92a-6dfc-4e40-9948-1ac12953312a" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-cdea1267-5640-41db-ada7-21e1f5e76dc8" }, { "name": "Create payin", "id": "78a83d51-a633-49f2-9990-f61377d022b7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] }, "description": "Create and process a payin with sensitive PCI data using a payin configuration. The merchant status must be `ACTIVE` to create a payin.\n\nThis endpoint requires Rainforest approval. Platforms that meet all [requirements](doc:send-sensitive-data-via-api#requirements) and are approved by Rainforest can send the full card and bank account numbers to Rainforest via a server-to-serve direct API integration." }, "response": [ { "id": "5e7cefbf-b82e-4367-818f-76e486a27c43", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"SUCCESS\",\n \"data\": {\n \"payin_id\": \"\",\n \"payin_config_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payment_method_id\": \"\",\n \"payment_method_config_id\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/payment_method_config_id not found in the OpenAPI spec\"\n },\n \"device_registration_id\": \"\",\n \"threeds_attempt_id\": \"\",\n \"idempotency_key\": {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D~1void/post/requestBody/content/application~1json/schema/properties/idempotency_key not found in the OpenAPI spec\"\n },\n \"billing_type\": \"NET\",\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"is_partially_authorized\": \"\",\n \"authorized_amount\": \"\",\n \"captured_amount\": \"\",\n \"refundable_amount\": \"\",\n \"non_refundable_reason_code\": \"FAILED\",\n \"status\": \"RETURNED\",\n \"refusal_code\": \"DECLINED\",\n \"refusal_desc\": \"Retry with 3DS\",\n \"detailed_refusal_code\": \"INSUFFICIENT_FUNDS\",\n \"detailed_refusal_desc\": \"Risk decline\",\n \"auth_code\": \"\",\n \"avs_result_code\": \"\",\n \"cvc_result_code\": \"\",\n \"amount_splits\": [\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n },\n {\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"type\": \"MERCHANT\",\n \"merchant_id\": \"\",\n \"platform\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_configs/post/requestBody/content/application~1json/schema/properties/platform not found in the OpenAPI spec\"\n },\n \"merchant\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/merchant not found in the OpenAPI spec\"\n }\n }\n ],\n \"merchant_fees\": {\n \"total_amount\": {\n \"amount\": \"\",\n \"currency_code\": \"USD\"\n }\n },\n \"method_type\": \"VENMO\",\n \"card\": {\n \"type\": \"CREDIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"American Express\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\"\n },\n \"apple_pay\": {\n \"type\": \"DEBIT\",\n \"brand\": {\n \"value\": \"reference #/paths/~1v1~1bin_lookup/post/responses/200/content/application~1json/schema/properties/data/properties/brand not found in the OpenAPI spec\"\n },\n \"brand_desc\": \"Discover\",\n \"description\": \"\"\n },\n \"ach\": {\n \"account_number_last_4\": \"\",\n \"routing_number\": \"\",\n \"bank_name\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"BUSINESS\"\n },\n \"plaid_ach\": {\n \"value\": \"reference #/paths/~1v1~1payment_methods/post/responses/200/content/application~1json/schema/properties/data/properties/plaid_ach not found in the OpenAPI spec\"\n },\n \"paypal_wallet\": {\n \"email\": \"\"\n },\n \"venmo\": {\n \"email\": \"\"\n },\n \"paypal_paylater\": {\n \"email\": \"\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n },\n \"device_data\": {\n \"application_identifier\": \"\",\n \"application_label\": \"\",\n \"application_preferred_name\": \"\",\n \"transaction_status_information\": \"\",\n \"application_pan_sequence_number\": \"\",\n \"entry_type\": \"KEYED\",\n \"verification_type\": \"SIGNATURE\",\n \"signature\": \"\"\n },\n \"method_metadata\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/method_metadata not found in the OpenAPI spec\"\n },\n \"metadata\": {},\n \"refunds\": [\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1refunds~1%7Brefund_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_refunds\": \"\",\n \"chargebacks\": [\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/paths/~1v1~1chargebacks~1%7Bchargeback_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n }\n ],\n \"has_chargebacks\": \"\",\n \"ach_return\": {\n \"value\": \"reference #/paths/~1v1~1ach_returns~1%7Bach_return_id%7D/get/responses/200/content/application~1json/schema/properties/data not found in the OpenAPI spec\"\n },\n \"has_ach_return\": \"\",\n \"payin_config\": {\n \"payin_config_id\": \"\",\n \"processing_mode\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/processing_mode not found in the OpenAPI spec\"\n },\n \"amount\": \"\",\n \"currency_code\": \"USD\",\n \"amount_splits\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/amount_splits not found in the OpenAPI spec\"\n }\n },\n \"threeds_attempt\": {\n \"threeds_attempt_id\": \"\",\n \"merchant_id\": {\n \"value\": \"reference #/paths/~1v1~1device_registrations/post/requestBody/content/application~1json/schema/properties/merchant_id not found in the OpenAPI spec\"\n },\n \"payin_config_id\": \"\",\n \"status\": \"FINGERPRINTED\",\n \"failed_reason_code\": \"UNEXPECTED_ERROR\",\n \"failed_reason_desc\": \"\",\n \"created_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"updated_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"fingerprinted_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"challenged_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"succeeded_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n },\n \"failed_at\": {\n \"value\": \"reference #/paths/~1v1~1payment_method_domains/post/requestBody/content/application~1json/schema/properties/created_at not found in the OpenAPI spec\"\n }\n },\n \"expected_deposit_date\": \"\",\n \"source\": \"EXTERNAL\",\n \"source_desc\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-5e7cefbf-b82e-4367-818f-76e486a27c43" }, { "id": "a7877115-d04d-434e-8a42-d01c36a3f918", "name": "Bad request, check for validation errors.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-a7877115-d04d-434e-8a42-d01c36a3f918" }, { "id": "4821b988-cad8-4752-a943-c5a4cbb0c1c9", "name": "Authorization missing or invalid.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-4821b988-cad8-4752-a943-c5a4cbb0c1c9" }, { "id": "1c88d7e1-3e48-48a9-ba73-5ecbacda611c", "name": "Authorization insufficient for requested action.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-1c88d7e1-3e48-48a9-ba73-5ecbacda611c" }, { "id": "cda28f96-545e-4af3-840d-37ef0d24bd6a", "name": "Unexpected error.", "originalRequest": { "method": "POST", "header": [ { "key": "Rainforest-Api-Version", "value": "2024-10-16" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"payin_config_id\": \"\",\n \"method_type\": \"ACH\",\n \"card\": {\n \"card_number\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cvc\": \"\"\n },\n \"ach\": {\n \"account_number\": \"\",\n \"routing_number\": \"\",\n \"account_type\": \"CHECKING\",\n \"account_holder_type\": \"PERSONAL\"\n },\n \"billing_contact\": {\n \"value\": \"reference #/paths/~1v1~1payin_configs/post/requestBody/content/application~1json/schema/properties/billing_contact not found in the OpenAPI spec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/payins", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payins" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"status\": \"ERROR\",\n \"data\": {},\n \"errors\": [\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"code\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-cda28f96-545e-4af3-840d-37ef0d24bd6a" } ], "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-78a83d51-a633-49f2-9990-f61377d022b7" } ], "id": "edaba79f-ffc9-4959-990f-cd1584782aea", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-edaba79f-ffc9-4959-990f-cd1584782aea" } ], "id": "11b409d1-b479-4d9e-b101-a8764cfca444", "createdAt": "2026-07-28T02:43:43.000Z", "updatedAt": "2026-07-28T02:43:43.000Z", "uid": "35240-11b409d1-b479-4d9e-b101-a8764cfca444" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sandbox.rainforestpay.com" } ] }